javascript单元测试中模拟全局配置对象的核心是隔离注入可控值,需根据配置来源选择策略:挂载全局变量需beforeeach/aftereach清理或object.defineproperty控制;模块导出配置应mock整个模块;顶层求值配置需vi.hoisted或动态导入提前干预。

直接挂载到 global/window(适合浏览器或 jsdom 环境)
若配置是全局变量(如 window.CONFIG 或 globalThis.API_BASE_URL),可在测试前临时赋值,测试后还原:
- 用 beforeEach/afterEach 确保每个测试独立:
beforeEach(() => { window.CONFIG = { API_URL: 'http://test.api' }; });afterEach(() => { delete window.CONFIG; }); - 更安全的做法是用 Object.defineProperty 控制可写性与可枚举性,防止被误删或覆盖:
Object.defineProperty(globalThis, 'APP_CONFIG', { value: { timeout: 1000 }, writable: true, configurable: true }); - 注意:必须在被测模块 import 之前 设置,否则模块已读取旧值,后续赋值无效
Mock 配置模块(推荐,适用于 ES 模块或 CommonJS)
当配置从独立文件导出(如 export const config = { ... }),应 mock 整个模块,而非改全局:
- Vitest 中,在测试文件顶部使用 vi.mock:
vi.mock('./config.ts', async (importOriginal) => { const actual = await importOriginal(); return { ...actual, config: { API_URL: 'http://mock' } }; }); - Jest 中类似,用 jest.mock + 工厂函数返回模拟对象:
jest.mock('./config', () => ({ config: { featureFlag: true } })); - 这样被测代码 import 的永远是 mock 值,无需操作全局,天然隔离
处理顶层读取的配置(防“import 时即求值”问题)
有些配置在模块顶层就执行了(如 const URL = process.env.API_URL || CONFIG.API_URL),此时常规 beforeEach 来不及干预。解决方式有:
- 用 vi.hoisted(Vitest)提前定义 mock 值,在模块加载前生效:
const mockConfig = vi.hoisted(() => ({ API_URL: 'http://hoisted' })); vi.mock('./config', () => ({ config: mockConfig })); - 或改用动态导入:
const { config } = await import('./config'),让 mock 在运行时才介入 - Jest 可配合 jest.isolateModules + require.requireActual 实现类似效果
类型安全与开发体验
TS 项目中,直接赋值可能报错(如 Property 'CONFIG' does not exist on type 'typeof globalThis'):
- 扩展全局接口:
declare global { interface GlobalThis { CONFIG: Record<string any>; } }</string> - 或临时断言:
(globalThis as any).CONFIG = {...}(仅限测试文件内) - 推荐在
test-setup.ts中统一声明和扩展,保持类型一致性
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











