如何在Jest中按测试用例模拟命名常量导出？

我懂你这个痛点——Jest的模块缓存机制真的很容易在这类场景下坑人。你之前的mock没生效，核心原因是被测模块在你执行mock操作之前就已经加载了真实的constants.js并被缓存，后续的mock根本没机会覆盖它。下面给你几个可行的解决方案，按推荐程度排序：

方案1：重置模块缓存 + 动态导入（推荐，无需修改原模块） #

这个方法通过清空Jest的模块缓存，确保每次测试都重新加载模块，让你的mock生效。同时我们会保留原常量的其他属性，只修改PORT，避免破坏其他依赖。

let randomPort;
let testedModule; // 替换成你的被测模块路径

beforeEach(async () => {
  randomPort = getRandomPort();
  
  // 1. 重置模块缓存，清空之前加载的所有模块
  jest.resetModules();
  
  // 2. Mock constants.js，保留原导出的其他内容，只覆盖PORT
  jest.mock('./constants', () => {
    const originalConstants = jest.requireActual('./constants');
    return {
      ...originalConstants,
      SERVER: {
        ...originalConstants.SERVER,
        PORT: randomPort
      }
    };
  });
  
  // 3. 动态导入被测模块（因为resetModules后模块被清空，需要重新加载）
  testedModule = await import('./your-tested-module');
});

it('should use the randomized port in test', () => {
  // 这里写你的测试逻辑，比如调用被测模块里用到端口的方法
  expect(testedModule.someFunctionThatUsesServerPort()).toBe(randomPort);
});

关键点说明： #

• jest.resetModules()：每次测试前清空模块缓存，确保被测模块会重新加载我们mock后的constants.js
• jest.requireActual('./constants')：获取真实的常量导出，避免把SERVER.HOST、PATHS等其他常量也覆盖掉
• 动态导入：因为resetModules会清空缓存，用await import()确保模块加载完成后再执行测试

方案2：修改原模块为可动态配置的（适合允许改动原代码的场景） #

如果可以修改constants.js，我们可以把PORT改成基于环境变量的动态值，这样不用依赖Jest的mock，更直接：

修改constants.js：

export const SERVER = { 
  HOST: 'localhost', 
  // 优先取测试环境变量，默认用8000
  get PORT() {
    return process.env.TEST_SERVER_PORT || 8000;
  }
};
export const PATHS = { LOGIN: '/login', LOGOUT: '/logout' };

然后在测试中：

let randomPort;

beforeEach(() => {
  randomPort = getRandomPort();
  // 设置环境变量
  process.env.TEST_SERVER_PORT = randomPort;
});

afterEach(() => {
  // 测试后清理环境变量，避免影响其他测试用例
  delete process.env.TEST_SERVER_PORT;
});

it('should pick up the dynamic port from env', () => {
  const { SERVER } = require('./constants');
  expect(SERVER.PORT).toBe(randomPort);
});

这个方案的好处是不需要处理Jest的模块缓存问题，逻辑更简单，但缺点是需要改动原业务代码。

方案3：使用jest.isolateModules()创建隔离上下文 #

Jest的isolateModules()会创建一个独立的模块加载上下文，在这个上下文里加载的模块不会和其他测试共享缓存，也能解决问题：

let randomPort;
let testedModule;

beforeEach(() => {
  randomPort = getRandomPort();
  
  jest.isolateModules(() => {
    // 在隔离上下文里mock constants
    jest.mock('./constants', () => {
      const original = jest.requireActual('./constants');
      return {
        ...original,
        SERVER: { ...original.SERVER, PORT: randomPort }
      };
    });
    
    // 用require同步加载被测模块
    testedModule = require('./your-tested-module');
  });
});

it('should use the isolated mock port', () => {
  expect(testedModule.getServerPort()).toBe(randomPort);
});

这个方案和方案1类似，但用同步的require即可，适合不喜欢异步导入的场景。

内容的提问来源于stack exchange，提问作者Christopher Francisco