Jest测试JavaScript代码教程详解

Jest 是专为 JavaScript（尤其是 React）打造的开箱即用测试解决方案，集测试运行器、断言库与模拟系统于一体，无需复杂配置即可快速启动单元测试——比如只需新建 `sum.test.js` 并运行 `npm test`，就能验证函数逻辑；但它的真正价值不仅在于“能测”，更在于对异步处理、对象深比较、定时器控制、模块模拟等真实开发痛点的原生支持，而配置灵活（如 `testEnvironment`、`setupFilesAfterEnv`）和工程化适配能力，也让它在复杂项目中游刃有余；不过，是否选用 Jest，关键不在技术本身，而在于你是否需要它提供的这些深度能力——否则轻量级替代方案可能更合适。

Jest 本身不是“用来测试 JavaScript 代码”的工具，而是专为 JavaScript（尤其是 React）设计的、开箱即用的测试运行器 + 断言库 + 模拟系统。如果你只是想验证一段普通 JS 函数逻辑是否正确，jest 完全能胜任；但若项目没用到其核心能力（如自动 mock、快照、React 测试工具链），可能反而比 vitest 或原生 node:test 更重。

如何写第一个 Jest 测试用例

关键不是“怎么配”，而是“怎么让 Jest 找到并执行你的测试文件”。默认规则是：匹配 __tests__/*.js、*.test.js 或 *.spec.js 的文件会被识别为测试文件。

• 新建 sum.js：

  function sum(a, b) { return a + b; } export { sum };

• 新建同目录下的 sum.test.js：

  import { sum } from './sum';
  test('adds 1 + 2 to equal 3', () => {
    expect(sum(1, 2)).toBe(3);
  });

• 确保已安装：npm install --save-dev jest，并在 package.json 中添加脚本："test": "jest"
• 运行 npm test —— 不需要额外配置即可跑通

为什么 test() 和 expect() 不报错但测试不通过

常见于异步逻辑未正确等待，或断言对象引用比较出错。Jest 的 expect() 默认做浅比较，对数组/对象内容不深查。

• 错误写法（异步未 await）：test('fetches data', () => { expect(fetch('/api')).resolves.toEqual(...); }); → 应该加 async/await 或返回 Promise
• 错误写法（对象比较）：expect(obj).toBe({a: 1}) → 总是失败，因为引用不同；改用 toEqual({a: 1})
• 错误写法（忘记清理定时器）：测试中用了 setTimeout 但没 jest.useFakeTimers() 或 jest.runAllTimers()，会导致测试卡住或超时

Jest 配置文件 jest.config.js 哪些项最常改

多数项目不需要配置文件就能跑，但以下几项一旦涉及真实工程场景，几乎必调。

• testEnvironment：默认 'jsdom'（模拟浏览器环境），纯 Node 工具库要改成 'node'
• setupFilesAfterEnv：用于引入全局测试辅助，比如 ['./src/setupTests.js']，里面可放 jest.mock() 或自定义匹配器
• moduleNameMapper：解决路径别名问题，例如把 @/components 映射到 /src/components
• transformIgnorePatterns：默认跳过 node_modules，但若你用了未编译的 ES 模块依赖（如某些现代 UI 库），需把它从忽略列表里移除

真正难的不是写测试，而是判断哪些逻辑值得测、哪些边界 case 容易漏——比如空输入、Promise reject、第三方 API 调用失败、并发修改共享状态。Jest 提供了能力，但要不要用、怎么用，得看函数本身的契约是否清晰。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~