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 提供了能力，但要不要用、怎么用，得看函数本身的契约是否清晰。
