用途
w-unit 用于为当前的代码变更补充单元测试。它的目标不是提高覆盖率数字,而是覆盖那些真正可能失败的行为,确保本次改动引入的公共 API、错误路径和回归点得到验证。
主要能力
- 依据仓库现有的测试技能(如 vitest-v5,或当前技术栈对应的测试技能)编写测试。
- 遵循仓库已有的文件命名与组织约定,将测试文件与实现文件放在同一目录(colocated),例如 *.test.ts 紧邻实现文件。
- 聚焦于可能失败的行为:公共 API、错误路径,以及本次变更需要防止的回归。
- 仅在文档化的边界处进行 mock,优先使用仓库中已有的真实类型和工厂,避免过度模拟。
使用方式
- 阅读相邻的测试文件以及仓库的测试技能,了解现有约定。
- 将 *.test.ts 测试文件与实现文件放在同一目录。
- 针对公共 API、错误路径和本次变更的回归点编写测试。
- 先运行聚焦的单个测试文件,确认通过后再运行包级测试脚本。
- 如果行为或命令发生变化,参考 /w-docs 文档。
适用场景
适用于需要为当前代码改动补充单元测试的开发流程,尤其是希望测试与实现就近放置、并遵循仓库既有测试规范的项目。
限制
不追求覆盖率百分比。关于具体支持的测试框架版本、安装命令、配置细节以及 /w-docs 的完整内容,资料中暂未提供。