JavaScript 中怎么在单元测试中 Mock 环境变量 process.env-js教程-PHP中文网

javascript单元测试中mock process.env需临时修改并还原以避免污染，推荐用框架工具如vi.stubenv或备份originalenv后在aftereach中恢复，确保测试独立可控。

javascript 中怎么在单元测试中 mock 环境变量 process.env

在 JavaScript 单元测试中 Mock process.env，核心是**临时修改或替换它，并在测试后还原**，避免污染其他测试。Node.js 的 process.env 是一个普通对象（尽管行为类似只读），可以安全地增删改——但必须注意清理。

直接赋值 + afterEach 还原（最常用）

适用于 Jest、Vitest 等主流测试框架。在每个测试前设置所需环境变量，在 afterEach 中清空或恢复原始值。

保存原始环境变量快照（推荐）：

test.js

let originalEnv;

beforeAll(() => {
  originalEnv = { ...process.env };
});

afterEach(() => {
  // 完全还原，包括被 delete 的键
  process.env = { ...originalEnv };
});

test('使用 API_URL 时发起正确请求', () => {
  process.env.API_URL = 'https://mock-api.com';
  // 执行被测代码...
  expect(someFunction()).toBe('https://mock-api.com/data');
});

用 Object.assign 或展开符局部覆盖

如果只改个别变量，且不想影响其他测试逻辑，可只覆盖目标字段，不删除无关项：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

process.env.NODE_ENV = 'test' —— 直接赋值，简单直接
Object.assign(process.env, { NODE_ENV: 'test', DEBUG: '1' }) —— 一次设多个
注意：delete process.env.SOME_KEY 也能生效，但记得在 afterEach 中补回（或统一还原）

使用 jest.mock() 模拟整个 process（谨慎）

不推荐直接 mock process 对象本身（可能破坏 Node 内部行为），但可 mock 依赖 process.env 的模块内部读取逻辑：

在被测模块中把 env 读取抽成函数或常量导出，便于替换
用 jest.mock('./config.js', () => ({ API_URL: 'https://stub.com' })) 替换配置模块
更稳妥：用 jest.isolateModules() 配合重写 require 缓存（适合复杂场景）

Vitest 用户注意点

Vitest 默认隔离环境，但 process.env 仍是共享的。务必手动还原：

用 vi.stubEnv('NODE_ENV', 'test')（Vitest 0.34+ 内置方法，自动清理）✅
或搭配 vi.unstubAllEnvs() 在 afterAll 中调用
示例：

vitest.config.ts

test('env stub works', () => {
  vi.stubEnv('DATABASE_URL', 'sqlite://test.db');
  expect(process.env.DATABASE_URL).toBe('sqlite://test.db');
});
// 自动还原，无需手动 afterEach

关键原则：不信任初始状态，每次测试独立可控；还原比设置更重要；优先用测试框架提供的工具（如 vi.stubEnv），其次再手动备份还原。