Jest框架如何测试javascript代码【教程】

Jest是专为javaScript（尤其是react）设计的开箱即用测试运行器+断言库+模拟系统；默认识别__tests__/、.test.js或.spec.js文件；需配置testEnvironment、setupFilesAfterEnv等适配工程需求。

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 哪些项最常改

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

立即学习“Java免费学习笔记（深入）”；

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

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