SuperAPI AI 工具集

jest-vitest

测试与质量

查看项目

更新于 10-26 16:17

技能介绍

用途:该技能面向使用 Jest 或 Vitest 编写 JavaScript/TypeScript 单元测试的场景,帮助组织测试结构、设计 Mock、处理异步、评估覆盖率并进行运行器配置。资料将其定位为单元测试技能,不适用于端到端或浏览器自动化测试(应使用 Playwright/Cypress 类技能),也不适用静态分析或代码检查。

主要能力:

  • 测试结构指导:采用 Arrange-Act-Assert 三段式;每个测试只验证一个行为概念;通过 beforeEach/afterEach 为每个测试创建全新实例,避免共享可变状态。
  • 匹配器与 Mock:列出 toBe、toEqual、toStrictEqual、toMatchObject、toContain、toThrow、toHaveBeenCalledWith、toHaveBeenCalledTimes 以及 resolves/rejects 的用途;区分函数 Mock(vi.fn/jest.fn)、Spy(vi.spyOn)与模块 Mock(vi.mock/jest.mock)。
  • 异步测试:演示 Promise 的 resolves/rejects 断言、假定时器(配合 useFakeTimers/useRealTimers 测试防抖)以及事件发射器的测试写法。
  • 快照测试:建议用于稳定且复杂的序列化输出,避免对渲染为 HTML 的 UI 组件使用快照;更新快照前应先审阅差异。
  • React 组件测试:使用 @testing-library 的 render、screen、fireEvent、userEvent、waitFor,并给出 getByRole > getByLabelText > getByPlaceholderText > getByText > getByTestId 的查询优先级。
  • 配置与覆盖率:给出 vitest.config.ts 示例(jsdom 环境、globals、setupFiles、v8 覆盖率与阈值、排除项)以及测试初始化文件示例;说明语句、分支、函数、行覆盖率指标,并指出分支覆盖率最具意义,建议业务逻辑分支覆盖率达到 80% 以上。
  • 反模式与易错点:包括测试实现细节、单个测试断言过多、Mock 自有内部代码、beforeAll 共享可变状态、滥用快照、未重置 Mock;还说明 vi.mock 提升与导入顺序、jsdom 下 Node API 行为差异、假定时器未清理、组件快照维护负担,以及 resetAllMocks、clearAllMocks、restoreAllMocks 的区别。

使用方式:资料描述为技能被激活后按主题提供指导,并附有代码示例;首次激活时会检查已安装的配套技能,如有缺失可提示安装(命令为 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>)。资料提到 references/migration-guide.md 可用于 Jest 到 Vitest 的迁移参考。

适用场景:编写、审查或改进 JS/TS 单元测试;实现 Mock;配置测试运行器;提升覆盖率;从 Jest 迁移到 Vitest;测试 React 组件。

限制:该技能不覆盖端到端或浏览器自动化测试,也不涉及静态分析或代码检查;资料未提供具体价格、平台授权或收费信息。