SuperAPI AI 工具集

atelier-typescript-testing

测试与质量

查看项目

更新于 10-16 00:06

技能介绍

用途:为 TypeScript 项目提供系统化测试模式,覆盖单元测试、API 模拟与快照验证,帮助编写类型安全、边界清晰的测试。

主要能力:使用 Vitest 编写 describe/it/expect 测试结构;通过 vi.mock 与 vi.mocked<T>() 创建类型安全的依赖注入 mock,支持 mockResolvedValue、mockResolvedValueOnce、mockImplementation、mockRejectedValue 等返回值控制;用 vi.spyOn 监视真实实现而不替换;用 MSW 的 http、HttpResponse、setupServer 在网络层拦截 HTTP 请求,配合 beforeAll/afterEach/afterAll 管理服务器生命周期;用 toMatchSnapshot 与 toMatchInlineSnapshot 校验复杂对象,并以 expect.any() 处理动态值;支持异步测试(Promise、回调、vi.useFakeTimers 假定时器)、错误边界测试、竞态条件测试与测试组织(分组、共享 setup)。

使用方式:按需安装依赖,示例为 bun add -d vitest @vitest/ui、bun add -d msw、可选 bun add -d @vitest/coverage-v8;测试文件中从 vitest 导入 describe、it、expect、vi、beforeEach 等。运行命令:vitest run path/to/test.spec.ts 运行单文件,vitest run -t "creates user" 按名称过滤,vitest watch 监听模式,vitest --ui 图形界面,vitest run --coverage 覆盖率报告。

适用场景:需要类型安全的 mock 与依赖注入、在集成测试中模拟 API、校验大型对象输出、控制时间相关逻辑、验证错误处理与并发行为的 TypeScript 项目。

限制:资料未提供对具体框架版本兼容范围、非 Vitest 运行器支持情况、MSW 浏览器端用法的说明;相关 mock、MSW、快照维护的深入内容以引用文件 references/mocking.md、references/msw.md、references/snapshot-testing.md 为准,本次未提供其内容。