jest.mock 是 jest 中用于完全替换第三方模块(如 axios、lodash)的最常用模拟方式,需在 import 前调用,支持默认/具名导出定制,并配合 clearallmocks 或 unmock 防止测试污染。

jest.mock 是 Jest 提供的最常用、最直接的模块模拟方式,适用于完全替换整个第三方模块(比如 axios、fs、lodash 等)的行为,让测试不依赖真实实现,专注逻辑验证。
基本用法:mock 整个模块并提供替代实现
在测试文件顶部调用 jest.mock('模块路径'),Jest 会自动用一个空的 mock 对象替换该模块。但通常你需要进一步定义它的导出内容:
- 对于默认导出(如
import axios from 'axios'),用mockImplementation或直接赋值给mock属性 - 对于具名导出(如
import { debounce } from 'lodash'),通过mockReturnValue或对象字面量设置具体方法
示例(模拟 axios):
jest.mock('axios');
import axios from 'axios';
// 模拟成功响应
axios.get.mockResolvedValue({ data: { id: 1, name: 'test' } });
// 在测试中调用实际代码(比如一个 fetchUser 函数)
test('fetches user successfully', async () => {
const result = await fetchUser(1);
expect(result.name).toBe('test');
expect(axios.get).toHaveBeenCalledWith('/api/users/1');
});
模拟具名导出的第三方模块(如 lodash)
如果模块只有具名导出(无默认导出),需用工厂函数返回一个包含对应方法的对象:
jest.mock('lodash', () => ({
debounce: jest.fn((fn) => fn), // 简单透传,跳过防抖
throttle: jest.fn((fn) => fn),
}));
import { debounce } from 'lodash';
test('debounce is called', () => {
const fn = jest.fn();
const debounced = debounce(fn, 100);
debounced();
expect(debounce).toHaveBeenCalledTimes(1);
});
注意模块路径和自动模拟时机
- 路径必须和
import语句中写的**完全一致**(包括大小写、扩展名省略规则)。例如jest.mock('fs'),不是'fs/promises'—— 后者需单独 mock -
jest.mock必须在import之前调用,否则会被忽略(Jest 在解析阶段已确定模块引用) - 若想只在某个测试中临时 mock,可用
jest.doMock+require动态导入,避免影响其他测试
还原 mock 避免测试污染
每个测试之间默认不自动清除 mock。为防止状态残留,推荐:
- 在
beforeEach中调用jest.clearAllMocks()(重置调用记录,保留 mock 结构) - 或在
afterEach中用jest.resetAllMocks()(重置所有,包括返回值配置) - 若需彻底恢复原始模块行为(比如只想 mock 某个测试),用
jest.unmock('module-name')
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











