17370845950

Jest 初始化需项目级安装并运行npx jest --init，选jsdom、.test.js后缀和覆盖率；首个测试用expect(1+2).toBe(3)验证；匹配器要按类型选用，mock须在import前声明并清理，异步测试必须正确await或return Promise。

Jest 是目前最主流的 JavaScript 单元测试框架，开箱即用、零配置起步快，但新手常卡在「写完测试却跑不起来」「断言失败但看不出哪错了」「mock 不生效」这几个地方。

如何初始化 Jest 并让第一个测试跑起来

不需要全局安装，项目级依赖更安全。执行命令后 Jest 会自动识别 .test.js 或 .spec.js 文件：

npm init -y
npm install --save-dev jest
npx jest --init

运行 npx jest --init 时建议：
- 选 Yes 启用 TypeScript 支持（即使当前没用 TS，后续加也方便）
- 选 jsdom 当作测试环境（模拟浏览器 DOM，适合 React/Vue 组件测试）
- 测试文件后缀选 .test.js
- 覆盖率报告选 Yes（后期排查漏测很有用）

生成的 jest.config.js 不用改，直接写一个最简测试就能验证环境：

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

然后运行 npx jest，看到 PASS 就说明基础链路通了。

expect() 的常见匹配器怎么选

expect() 后面接的不是函数调用，而是「断言意图」，选错匹配器会导致报错信息难懂或逻辑误判：

• toBe() 用于严格相等（===），适合数字、字符串、布尔、null、undefined
• toEqual() 用于对象/数组深比较，比如 expect(obj).toEqual({a: 1})
• toContain() 检查数组是否含某元素，或字符串是否含子串
• toThrow() 验证函数抛出错误，必须传函数引用，不能写 fn()
• toBeCalledTimes(n) 和 toHaveBeenCalledWith(...args) 专用于 mock 函数校验

容易踩的坑：
- 用 toBe() 比较对象 → 总是 false，因为引用不同
- 写 expect(fn()).toThrow() → 报错，应写 expect(() => fn()).toThrow()

如何正确 mock 一个模块或函数

mock 的核心目标是「隔离被测代码依赖」，而不是「让测试看起来能过」。常见错误是 mock 位置不对或没还原：

• 模块级 mock 必须放在文件顶部，且在 import 之前，否则无效
• 用 jest.mock('./module') 自动 mock 整个模块，内部所有导出都变成 mock 函数
• 想只 mock 某个函数，用 jest.fn() 替换它，再通过 jest.mock('./module', () => ({ func: jest.fn() })) 注入
• 测试完记得调用 jest.clearAllMocks() 或 jest.restoreAllMocks()，避免污染其他测试

例如 mock fetch：

global.fetch = jest.fn();
// 然后在测试中控制返回值：
fetch.mockResolvedValueOnce({ json: () => Promise.resolve({ id: 1 }) });

异步测试怎么写才不会超时或漏 await

Jest 默认等待 5 秒，但异步逻辑若没显式处理，会跳过断言直接报 Timeout。三种写法必须对应清楚：

• 返回 Promise：函数末尾 return fetch(...).then(...)，Jest 自动等待
• 使用 async/await：函数声明加 async，内部 await 所有异步操作
• 回调形式：函数参数加 done，并在异步完成时调用 done()（少用，易忘）

错误示范：
test('fetches data', () => { await fetch('/api'); expect(...); }) → 语法错误，必须加 async
test('fetches data', async () => { fetch('/api'); expect(...); }) → 没 await，断言在请求发出前就执行了

真实项目里最难的不是写测试，而是判断「该不该测」「测到什么粒度」——比如工具函数必须全覆盖，但组件渲染逻辑往往更适合集成测试；mock 过细会让测试脆弱，过粗又失去隔离意义。这些边界得结合具体代码慢慢试出来。