jest

适用场景

在用户希望执行以下操作时使用此技能：

• 使用 Jest 编写单元测试和集成测试
• 在项目中设置 Jest
• 使用 Jest 匹配器和断言
• 测试异步代码
• 模拟函数、模块和依赖项
• 创建快照测试
• 为不同环境配置 Jest
• 将 Jest 与 TypeScript、React、Vue 或其他框架配合使用
• 运行测试并生成覆盖率报告
• 使用 Jest CLI 命令
• 设置测试环境（jsdom、node）
• 在 Vite 项目中使用 Jest（通过 vite-jest，但对于新的 Vite 项目，建议使用 Vitest）

如何使用此技能

此技能按照 Jest 官方文档结构组织（https://jestjs.io/docs/getting-started、https://jestjs.io/docs/api）。使用 Jest 时：

1. 根据用户请求确定主题：

   • 入门/快速开始 → examples/getting-started/installation.md 或 examples/getting-started/using-matchers.md
   • 测试/测试 → examples/testing/asynchronous.md 或 examples/testing/setup-teardown.md
   • 模拟函数/Mock 函数 → examples/testing/mock-functions.md
   • 模拟模块/Mock 模块 → examples/testing/manual-mocks.md
   • 快照/快照 → examples/testing/snapshot-testing.md
   • 配置/配置 → examples/configuration/jest-config.md
   • CLI/命令行 → examples/configuration/cli-options.md

2. 从 examples/ 目录加载合适的示例文件：

   入门（快速开始）- examples/getting-started/：

   • examples/getting-started/installation.md - 安装 Jest 并进行基本设置
   • examples/getting-started/using-matchers.md - 使用 Jest 匹配器和断言

   测试（测试）- examples/testing/：

   • examples/testing/asynchronous.md - 测试异步代码
   • examples/testing/setup-teardown.md - 设置和清理函数
   • examples/testing/mock-functions.md - 模拟函数
   • examples/testing/manual-mocks.md - 手动模拟
   • examples/testing/snapshot-testing.md - 快照测试
   • examples/testing/timer-mocks.md - 模拟计时器
   • examples/testing/es6-class-mocks.md - 模拟 ES6 类

   配置（配置）- examples/configuration/：

   • examples/configuration/jest-config.md - Jest 配置选项
   • examples/configuration/cli-options.md - CLI 选项和标志
   • examples/configuration/babel.md - 将 Jest 与 Babel 配合使用
   • examples/configuration/typescript.md - 将 Jest 与 TypeScript 配合使用

   指南（指南）- examples/guides/：

   • examples/guides/migrating-to-jest.md - 迁移到 Jest
   • examples/guides/testing-react-apps.md - 测试 React 应用
   • examples/guides/testing-vue-apps.md - 测试 Vue 应用

3. 遵循相应示例文件中的具体说明，了解语法、结构和最佳实践

   重要提示：

   • 所有示例均遵循 Jest 最佳实践
   • 在适用的情况下，示例同时提供 JavaScript 和 TypeScript 版本
   • 每个示例文件都包含核心概念、代码示例和要点
   • 务必查看示例文件，了解最佳实践和常见模式

4. 必要时参考 api/ 目录中的 API 文档：

   • api/expect.md - expect() API 和匹配器
   • api/mock-functions.md - Mock 函数 API
   • api/jest-object.md - Jest 对象 API
   • api/test.md - test() 和 describe() API
   • api/cli.md - CLI 命令和选项

5. 使用 templates/ 目录中的模板：

   • templates/jest-config.md - Jest 配置模板
   • templates/test-template.md - 测试文件模板
   • templates/setup-file.md - 设置文件模板

文档映射（与 https://jestjs.io/docs/getting-started、https://jestjs.io/docs/api 一一对应）

快速开始（快速开始）：

• examples/getting-started/installation.md → https://jestjs.io/docs/getting-started
• examples/getting-started/using-matchers.md → https://jestjs.io/docs/using-matchers

测试（测试）：

• examples/testing/asynchronous.md → https://jestjs.io/docs/asynchronous
• examples/testing/setup-teardown.md → https://jestjs.io/docs/setup-teardown
• examples/testing/mock-functions.md → https://jestjs.io/docs/mock-functions
• examples/testing/manual-mocks.md → https://jestjs.io/docs/manual-mocks
• examples/testing/snapshot-testing.md → https://jestjs.io/docs/snapshot-testing
• examples/testing/timer-mocks.md → https://jestjs.io/docs/timer-mocks
• examples/testing/es6-class-mocks.md → https://jestjs.io/docs/es6-class-mocks

配置（配置）：

• examples/configuration/jest-config.md → https://jestjs.io/docs/configuration
• examples/configuration/cli-options.md → https://jestjs.io/docs/cli

API 参考：

• api/expect.md → https://jestjs.io/docs/expect
• api/mock-functions.md → https://jestjs.io/docs/mock-functions
• api/jest-object.md → https://jestjs.io/docs/jest-object
• api/test.md → https://jestjs.io/docs/api#testname-fn-timeout
• api/cli.md → https://jestjs.io/docs/cli

示例和模板

此技能包含详细示例，按官方文档结构组织。所有示例都位于 examples/ 目录中（参见上方映射）。

使用示例：

• 根据用户请求确定主题
• 从上方映射中加载相应的示例文件
• 遵循该文件中的说明、语法和最佳实践
• 根据具体用例调整代码示例

使用模板：

• 参考 templates/ 目录中的常用脚手架模板
• 根据具体需求和编码风格调整模板

最佳实践

1. 编写描述性测试名称：使用清晰且具有描述性的测试名称
2. 使用合适的匹配器：为每个断言选择正确的匹配器
3. 模拟外部依赖：模拟外部 API、数据库和服务
4. 测试边界情况：测试正常路径和错误情况
5. 保持测试隔离：每个测试都应相互独立
6. 使用设置和清理：正确清理资源
7. 快照测试：对 UI 组件使用快照，但要检查变更
8. 覆盖率目标：追求有意义的覆盖率，而不只是较高的百分比
9. 组织测试：使用 describe 块对相关测试进行分组
10. 异步测试：使用 async/await 或 promises 正确处理异步代码

资源

• 官方文档：https://jestjs.io/
• 快速开始：https://jestjs.io/docs/getting-started
• API 参考：https://jestjs.io/docs/api
• GitHub 仓库：https://github.com/jestjs/jest

关键词

Jest、测试、单元测试、集成测试、Mock、spy、快照、匹配器、断言、异步测试、设置、清理、覆盖率、CLI、配置、TypeScript、React、Vue、Babel、测试、单元测试、集成测试、Mock、快照、匹配器、断言、异步测试、覆盖率、配置