Jest 测试中动态切换手动 Mock 与真实模块实现

---

本文详细阐述了在 Jest 测试框架中，当存在模块的手动 Mock 实现时，如何在特定测试用例或测试套件中选择性地使用模块的真实实现。核心解决方案是结合使用 jest.dontMock(moduleName) 和 jest.resetModules()，以确保测试环境的灵活性和准确性。

挑战与需求

在 Jest 中进行单元测试时，我们经常会为外部依赖（如网络请求库 Axios、数据库连接等）创建手动 Mock (__mocks__/moduleName.js)。这种方式能有效地隔离被测模块，使测试聚焦于其自身逻辑，避免真实依赖带来的副作用或性能开销。

然而，在某些场景下，我们可能需要验证模块与真实依赖的集成情况，或者在同一个测试文件中，某些测试用例需要 Mock，而另一些则需要真实的模块实现。直接在测试用例内部使用 jest.mock("moduleName", () => jest.requireActual("moduleName")) 往往无法达到预期效果，因为 Jest 的模块加载机制在测试执行前就已经处理了手动 Mock，后续的 jest.mock 调用可能无法覆盖已缓存的 Mock。

解决方案：jest.dontMock 与 jest.resetModules

要实现动态切换，我们需要结合使用 Jest 提供的两个关键 API：

1. jest.dontMock(moduleName): 此函数指示 Jest 不对指定模块进行 Mock。它会取消对该模块的任何现有 Mock 定义，包括手动 Mock。
2. jest.resetModules(): 此函数会清除 Jest 的模块注册表（即所有已导入模块的缓存）。这至关重要，因为 jest.dontMock 仅指示 Jest "下次" 不要 Mock，而要让其生效，我们需要强制 Jest 重新加载模块。

通过在测试用例或 beforeEach 钩子中先调用 jest.resetModules() 清除模块缓存，再调用 jest.dontMock('moduleName')，可以确保当模块被重新导入时，Jest 会加载其真实实现而非 Mock。

实战示例

以下通过一个使用 axios 的具体例子，演示如何在一个测试套件中同时测试 Mocked axios 和真实 axios 的行为。

1. 设置手动 Mock (__mocks__/axios.js)

首先，创建一个 axios 的手动 Mock。这个 Mock 会拦截 axios.get 调用并返回一个预设的假数据。

Jaaz

开源的AI设计智能体

216 查看详情

// __mocks__/axios.js
let mockAxios = jest.genMockFromModule('axios');

// 为 get 方法提供一个 Mock 实现
mockAxios.get = jest.fn().mockResolvedValue({ data: 'fake' });

export default mockAxios;

2. 被测试的模块 (main.ts)

这是一个简单的模块，它使用 axios 发起一个 GET 请求。

// main.ts
import axios from 'axios';

export function main() {
  return axios.get('https://jsonplaceholder.typicode.com/todos/1');
}

3. 测试文件 (main.test.ts)

在这个测试文件中，我们将编写两个测试用例：一个使用 Mocked axios，另一个使用真实的 axios。

// main.test.ts
import { main } from './main'; // 导入被测试的模块

describe('Axios 模块切换测试', () => {
  // 在每个测试用例运行前重置模块缓存
  beforeEach(() => {
    jest.resetModules();
  });

  test('应该使用 Mocked Axios', async () => {
    // 默认情况下，如果存在手动 Mock，Jest 会使用它
    const result = await main();
    expect(result.data).toEqual('fake'); // 验证是否返回 Mock 数据
    console.log('Mocked Axios 结果:', result.data);
  });

  test('应该使用真实的 Axios', async () => {
    // 在这个测试用例中，我们取消对 axios 的 Mock
    jest.dontMock('axios');

    // 由于 beforeEach 中已经 resetModules，这里重新导入 main 模块
    // 此时 main 模块内部引用的 axios 将是真实的 axios
    const { main: actualMain } = await import('./main');
    const result = await actualMain();

    // 验证是否返回真实数据（通常是来自 API 的 JSON 对象）
    expect(result).toH*eProperty('data');
    expect(result.data).toH*eProperty('userId');
    expect(result.data).toH*eProperty('id');
    console.log('真实 Axios 结果:', result.data);
  });
});

4. 运行测试与结果分析

运行上述测试后，你将看到类似以下的输出：

 console.log
    Mocked Axios 结果: fake

 console.log
    真实 Axios 结果: { userId: 1, id: 1, title: 'delectus aut autem', completed: false }

 PASS  ./main.test.ts
  Axios 模块切换测试
    ✓ 应该使用 Mocked Axios (XX ms)
    ✓ 应该使用真实的 Axios (YY ms)

Test Suites: 1 passed, 1 total
Tests:       2 passed, 2 total
Snapshots:   0 total
Time:        ZZ s

从输出可以看出，第一个测试用例成功地使用了手动 Mock 返回了 'fake' 数据，而第二个测试用例则成功地发起了真实的网络请求，并从 jsonplaceholder.typicode.com 获取了真实的数据。这证明了 jest.dontMock 和 jest.resetModules 组合的有效性。

注意事项与最佳实践

1. jest.resetModules() 的位置: 将 jest.resetModules() 放在 beforeEach 钩子中是推荐的做法。这确保了每个测试用例都在一个干净的模块环境中启动，避免了测试之间的状态污染。
2. jest.dontMock() 的作用域: jest.dontMock() 调用会影响当前测试文件或 describe 块中后续的模块加载。如果你在一个 describe 块的 beforeAll 或 beforeEach 中调用它，那么该块内的所有测试都将受到影响。
3. 模块重新导入: 当你调用 jest.resetModules() 后，任何之前导入的模块都需要重新导入才能反映新的 Mock/un-Mock 状态。在示例中，我们通过 await import('./main') 重新获取了 main 模块。
4. 性能考量: jest.resetModules() 会清除所有模块缓存，这意味着 Jest 需要重新加载所有依赖。对于大型项目，频繁地在每个测试用例中调用 jest.resetModules() 可能会略微增加测试运行时间。在实际应用中，应权衡灵活性和性能，仅在必要时使用。
5. 替代方案: 对于一些简单的场景，如果只是想在 Mock 中调用真实实现的一部分，jest.requireActual() 可以在 Mock 文件内部使用，例如 const actualAxios = jest.requireActual('axios'); mockAxios.post = actualAxios.post;。但这与本文讨论的动态切换整个模块 Mock 的场景有所不同。

总结

在 Jest 测试中，通过巧妙地结合使用 jest.dontMock(moduleName) 和 jest.resetModules()，我们可以实现对模块 Mock 行为的精细控制。这种方法允许开发者在同一测试套件中灵活地切换使用模块的 Mock 实现或真实实现，从而满足更复杂的测试需求，确保测试的全面性和准确性。理解并掌握这一技巧，将极大地提升 Jest 测试的灵活性和效率。

以上就是Jest 测试中动态切换手动 Mock 与真实模块实现的详细内容，更多请关注其它相关文章！

# 这一  # seo专员考核指标  # 天门seo优化电话  # 霍州网络营销的推广  # 营销推广需要注意哪些  # 九龙坡短视频seo获客  # 外贸营销网站建设托管  # 大庆seo排名打造企业  # 市场营销和推广的面试  # 空调推广网站  # 关键词出价多少排名靠前  # 第一个  # 都在  # 放在  # react  # 自定义  # 测试中  # 在这个  # 套件  # 加载  # yy  # 作用域  # 注册表  # ios  # ai  # axios  # json  # js 

相关栏目： 【 Google疑问12 】 【 Facebook疑问10 】 【 优化推广96088 】 【 技术知识133117 】 【 IDC资讯59369 】 【 网络运营7196 】 【 IT资讯61894 】

相关推荐： Google Drive API服务器端访问指南：服务账户认证详解  小米倒班助手添加日历提醒  《下一站江湖2》独孤剑诀习得方法  《气泡星球》兑换码礼包大全  我的世界官方网址入口 我的世界游戏主页直达入口  除了Copilot，还有哪些值得一试的VS Code AI插件？  百度识图图像分析 百度识图识别平台  J*aScript字符串_Unicode处理  《随手记》关闭首页消息推送方法  有道AI翻译入口 智能写作官方网站入口  TikTok视频播放中断怎么办 TikTok播放异常修复方法  Sublime怎么自动添加CSS前缀_Sublime安装Autoprefixer插件  《撕歌》会员开通方法  支付宝登录刷脸不是本人如何解决  百度竞价WAP显示PC链接问题  poki官网最新入口 poki小游戏大全入口  J*aScript深度克隆：实现高效、健壮与安全的复杂对象复制  QQ网页版入口导航 QQ网页版在线访问通道  《火影忍者：木叶高手》快速升级攻略  申通快递物流信息查询 申通快递包裹状态追踪  晓晓优选app支付宝绑定方法  Word 2003字体大小设置方法  如何在vscode中关闭it环境  sf漫画官网登录入口直达_sf漫画官方正版网址  食品生产用水只要符合国家规定的生活饮用水卫生标准就可以吗  《U校园》学生登录入口2025  J*aScript装饰器_元编程实战  Python中处理嵌套字典与列表的数据提取与过滤教程  PHP中实现JSON数据数组分页的教程  济南公交卡手机充值指南  《崩坏：星穹铁道》3.6版本异相仲裁打法及配队推荐  《米姆米姆哈》米姆获取及技能攻略  PySimpleGUI中实现键盘按键与按钮事件绑定教程  Scipy Sparse CSR 矩阵非零元素行级遍历的最佳实践  如何通过settings.json个性化您的VS Code体验  TikTok网页版入口快速访问 TikTok官网账号登录方法  《知到》打卡课程方法  智云Q3和Q2有什么升级_智云Q3与Q2手持云台功能与性能对比分析  《健康大兴》注册方法介绍  Excel如何快速合并单元格内容_Excel文本合并与函数操作技巧  J*aScript与HTML元素交互：图片点击事件与链接处理教程  铁路12306入口 铁路12306官网版入口登录网址  Windows Audio服务启动失败怎么办_电脑没声音的终极服务修复法【修复】  抖音赚钱快速入门_新手必看的抖音赚钱步骤  外卖小程序对接第三方配送  如何查找哪个composer包引入了特定的依赖？  视频号视频怎么提取文案?提取的文案如何优化与使用?  如何在CSS中使用伪类选择器_hover实现悬停效果  安居客移动经纪人怎么设置自动回复？-安居客移动经纪人设置自动回复的方法  聚水潭ERP后台管理系统登录 聚水潭ERP官方登录通道 

 2025-10-29