javascript中可通过jest.mock()工厂函数、commonjs模块替换或proxy代理实现partial mock:仅mock指定方法,其余保留真实逻辑,需注意模块加载机制与mock清理。

JavaScript 中没有原生的“部分 Mock”语法,但可以通过手动替换模块中的个别方法、结合 ES 模块动态导入或 CommonJS 的可变引用特性来实现 Partial Mock —— 即只 mock 某些函数,保留其余逻辑不变。
利用 ES 模块 + jest.mock() 的 factory 参数(推荐 Jest 用户)
Jest 支持在 jest.mock() 中传入 factory 函数,返回一个“代理对象”,其中只覆盖需要 mock 的方法,其余属性通过 require.requireActual() 委托给原始模块:
// 假设被测文件依赖 ./api.js
// api.js 导出 { fetchUser, fetchPost, utils }
jest.mock('./api', () => {
const actualApi = jest.requireActual('./api');
return {
...actualApi, // 保留所有原始导出
fetchUser: jest.fn().mockResolvedValue({ id: 1, name: 'Mock User' }), // 只 mock fetchUser
};
});
这样 fetchPost 和 utils 仍走真实逻辑,而 fetchUser 被拦截。注意:必须在 import 语句之前调用 jest.mock(),且模块路径需与 import 一致(包括扩展名)。
CommonJS 环境下直接修改 module.exports(Node.js / Mocha)
若使用 require 加载模块,可在测试前缓存原始方法,再替换目标方法:
- 先
const original = require('./service')获取原始对象 - 用
jest.spyOn(original, 'methodToMock').mockImplementation(...)或直接赋值original.methodToMock = jest.fn(...) - 确保被测代码
require的是同一模块实例(Node 缓存机制保证单例)
⚠️ 注意:该方式要求模块导出的是对象(非具名函数或 default 导出),且不能是冻结对象(Object.freeze 会阻止赋值)。
运行时代理(无测试框架时的轻量方案)
对任意模块对象,可用 Proxy 创建“部分拦截”的包装器:
const realModule = require('./logger');
const partialMockLogger = new Proxy(realModule, {
get(target, prop) {
if (prop === 'error') {
return (...args) => console.log('[MOCKED ERROR]', ...args);
}
return target[prop]; // 其他方法走真实逻辑
}
});
// 在被测代码中注入 partialMockLogger 替代 realModule
适合集成测试或调试场景,不依赖 Jest,但需主动控制模块注入时机(如通过构造函数参数或 setter 注入)。
关键提醒
- ESM 的
import是只读绑定,无法直接重赋值导出项;必须用jest.mock()工厂函数或构建时插件(如 vitest 的vi.mock()) - 避免 mock 深层嵌套方法(如
obj.nested.fn),优先 mock 直接导出的顶层函数 - 测试结束后建议调用
jest.restoreAllMocks()或手动恢复,防止 mock 泄漏影响其他测试
核心思路始终是:保留原始模块行为主体,仅对关注点做可控替换。不复杂但容易忽略细节。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











