JS中Mock全局对象需用Jest.spyOn或msw等工具安全可控地模拟,避免直接赋值污染;Jest需配jsdom环境模拟浏览器全局,msw通过Service Worker拦截请求零侵入;手动mock务必保存原值并清理。

在 JS 项目中,Mock 全局对象和变量主要是为了隔离外部依赖、控制测试环境行为,或在开发阶段模拟尚未实现的 API 或浏览器环境。常用方式不是靠“全局 mock”本身,而是通过工具(如 Jest、Sinon、msw)或手动替换 + 恢复机制来安全、可逆地干预全局作用域。
用 Jest 的 jest.mock() 和 jest.spyOn() 替换全局属性
Jest 提供了对全局对象(如 window、localStorage、fetch)的安全模拟能力,关键是避免直接赋值污染真实全局,而用 spyOn + mockImplementation 控制行为,并自动在测试后还原。
- 模拟
fetch:在测试前调用jest.spyOn(global, 'fetch').mockImplementation(...),测试结束后 Jest 自动恢复(也可手动.mockRestore()) - 模拟自定义全局变量(如挂载在
window上的 SDK):Object.defineProperty(window, 'MySDK', { value: mockSDK, writable: true }),再配合beforeEach/afterEach清理 - 注意:Jest 默认运行在 Node 环境,若需模拟浏览器全局(
window、document),应启用testEnvironment: 'jsdom'
用 msw(Mock Service Worker) 拦截网络请求,不碰全局对象
对于 API 层的 Mock,推荐 msw —— 它不修改 fetch 或 XMLHttpRequest,而是通过 Service Worker 拦截请求,完全解耦、零侵入。适用于开发联调和 E2E 测试。
- 安装后,在入口或测试 setup 中启动 worker:
worker.start({ onUnhandledRequest: 'bypass' }) - 定义 handlers 模拟响应:
rest.get('/api/user', (req, res, ctx) => res(ctx.status(200), ctx.json({ id: 1 }))) - 无需 patch 全局,不影响其他测试;支持真实请求流程,比纯内存 mock 更贴近生产行为
手动 mock 全局变量时,务必做清理和防御
在非 Jest 环境(如普通脚本、Vite 插件、或需要快速验证时),可临时覆盖全局变量,但必须确保可恢复、不泄漏到后续执行中。
- 保存原始值:
const originalFetch = global.fetch,mock 后在finally或afterEach中赋回 - 使用
Object.defineProperty替代直接赋值,能更精准控制可写性、可枚举性,防止被意外覆盖 - 避免在模块顶层 mock(如
global.MyVar = {}),否则会污染所有后续测试;应在测试函数内、作用域受限处操作
避免常见陷阱
Mock 全局对象容易引发隐性问题,需特别留意:
-
跨测试污染:未清理的 mock 可能影响下一个测试,始终用
beforeEach/afterEach或jest.resetModules() -
ESM 静态导入不可 mock:不能直接 mock 已 import 的模块导出,需用
jest.unstable_mockModule(Jest 28+)或改用动态import() -
类型丢失:手动 mock 会丢失 TypeScript 类型推导,建议配合
declare global补充类型声明或使用类型安全的 mock 库(如vitest-mock-extended)











