Jest 是 JavaScript 单元测试最常用、上手最友好的方案，开箱即用，自带断言库、Mock 工具、覆盖率报告和测试运行器；支持 ES Module，需配置 jest.config.js；通过 test() 和 expect().matcher 编写测试，可模拟依赖、验证异步逻辑。
JavaScript 单元测试最常用、上手最友好的方案就是 Jest。它开箱即用，自带断言库、Mock 工具、覆盖率报告和测试运行器，不需要额外配置就能跑起来。
安装与基础配置
在项目根目录下执行：
npm install --save-dev jest
在 package.json 的 scripts 中添加：
"test": "jest",
"test:watch": "jest --watch"
如果项目使用 ES Module（比如有 type: "module"），需在 jest.config.js 中启用 ESM 支持（Jest 29+ 原生支持）：
立即学习“Java免费学习笔记（深入）”；
export default {
testEnvironment: 'node',
extensionsToTreatAsEsm: ['.ts', '.js'],
transform: {
'^.+\\.js$': ['babel-jest', { presets: ['@babel/preset-env'] }],
},
};编写第一个测试文件
Jest 默认匹配 *.test.js 或 *.spec.js 文件。比如你有一个 math.js：
// math.js
export const add = (a, b) => a + b;
export const multiply = (a, b) => a * b;
对应写一个 math.test.js：
// math.test.js
import { add, multiply } from './math.js';
test('add returns correct sum', () => {
expect(add(2, 3)).toBe(5);
});
test('multiply returns correct product', () => {
expect(multiply(4, 5)).toBe(20);
});
运行 npm test 就能看到通过结果。
常用断言与测试技巧
Jest 提供丰富的 expect().matcher 方法，覆盖大多数验证场景：
- toBe()：严格相等（适合原始值）
- toEqual()：深度相等（适合对象、数组）
- toBeTruthy() / toBeFalsy()：检查真值/假值
- toThrow()：验证是否抛出错误
- toHaveBeenCalledTimes()：配合 jest.fn() 检查函数调用次数
例如测试异步函数：
test('fetches user data', async () => {
const userData = await fetchUser(123);
expect(userData.name).toBe('Alice');
});或者用 await expect(...).resolves 更安全地捕获 Promise 成功结果。
模拟依赖（Mocking）
测试时经常要隔离外部影响，比如 API 调用、定时器或第三方库。Jest 内置强大 Mock 功能：
- jest.fn() 创建模拟函数，可记录调用、返回固定值或抛错
- jest.mock('./module') 自动 mock 模块（会自动替换其所有导出）
- jest.useFakeTimers() 替换 setTimeout 等，让时间控制可控
例子：mock 一个发请求的函数
import { fetchData } from './api.js';
jest.mock('./api.js'); // 自动 mock
test('shows loading then data', () => {
fetchData.mockResolvedValue({ id: 1, name: 'Bob' });
// ...触发组件逻辑
expect(fetchData).toHaveBeenCalledTimes(1);
});基本上就这些。Jest 不复杂但容易忽略细节，比如默认不支持顶层 await、ESM 导入路径别名需要额外配置。从简单函数开始写，逐步覆盖分支逻辑和副作用，测试就会自然成为开发节奏的一部分。
