mockimplementation 是 jest 用于动态替换被 mock 函数执行逻辑的核心 api,支持返回不同值、抛错、调用回调等;可结合闭包维持状态,配合 mockimplementationonce 实现单次定制,且需在每个测试中显式设置以避免逻辑污染。

mockImplementation 是 Jest 提供的核心 API,用于**动态替换被 mock 函数的执行逻辑**,特别适合在不同测试用例中为同一函数注入不同行为(比如返回不同值、抛错、调用回调等)。
基本用法:用函数体覆盖原实现
调用 mockImplementation 时传入一个函数,该函数会在每次调用 mock 函数时执行:
const myFn = jest.fn(); myFn.mockImplementation((a, b) => a + b); console.log(myFn(2, 3)); // 输出 5
它会完全忽略原始函数逻辑,只执行你传入的函数体。
支持闭包和外部状态,实现“有记忆”的 mock
你可以利用闭包变量,在多次调用间保持状态,模拟计数、切换返回值等场景:
- 模拟首次调用失败、后续成功:
let callCount = 0;
myFn.mockImplementation(() => {
callCount++;
return callCount === 1 ? Promise.reject(new Error('timeout')) : Promise.resolve('ok');
});
- 模拟按顺序返回不同值(类似
mockReturnValueOnce,但更灵活):
const responses = ['user1', 'user2', 'error']; myFn.mockImplementation(() => responses.shift() || 'default');
配合 mockImplementationOnce 实现单次定制
如果只需某一次调用走特定逻辑,用 mockImplementationOnce 更简洁,它会自动 fallback 到默认实现(或 undefined):
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
myFn .mockImplementationOnce(() => 'first') .mockImplementationOnce(() => 'second') .mockImplementation(() => 'always after');
注意:链式调用时,mockImplementationOnce 不会覆盖后续的 mockImplementation,而是按调用顺序依次生效。
在测试中重设或更新逻辑(避免污染)
每个测试用例应独立控制 mock 行为。推荐在 beforeEach 或测试内显式设置:
test('handles success', () => {
api.fetchUser.mockImplementation(() => Promise.resolve({ id: 1 }));
// ...
});
test('handles error', () => {
api.fetchUser.mockImplementation(() => Promise.reject(new Error('404')));
// ...
});
无需手动清除 —— Jest 在每个 test 后自动重置 mock 的调用记录;但实现逻辑(implementation)不会自动重置,所以**必须显式重新设置**,否则会继承上一个 test 的逻辑。
不复杂但容易忽略:mockImplementation 是函数级别的行为劫持,不是声明时绑定,而是在运行时生效,因此时机和作用域很关键。










