如何在Jest测试套件内部获取执行命令传入的CLI选项与目标测试列表

问题根因 #

Jest执行测试任务时会启动独立Worker子进程运行测试代码，和执行npx jest的主进程做了完全隔离，测试文件内调用process.argv拿到的就是Worker自身的启动参数，也就是你看到的['/usr/local/bin/node', '/app/node_modules/jest-worker/build/workers/processChild.js']。这条路完全走不通，不存在原生Node.js能力可以直接跨沙箱读取主进程的命令行输入。

官方支持的可行实现方式 #

• 方案1：通过Jest配置层透传自定义全局值
  Jest的配置文件本身运行在主进程环境，可以直接读取完整的命令行参数，你可以在配置解析阶段把传入的测试筛选参数写入Jest的全局配置，这部分值会被序列化后透传到所有Worker进程，测试套件内可以直接读取。
  示例配置：

  // jest.config.js（运行在主进程）
  module.exports = async () => {
    // 过滤掉带短横线的配置项，拿到用户传入的纯位置参数（即测试匹配值）
    const cliTestArgs = process.argv.slice(2).filter(arg => !arg.startsWith('-') && !arg.includes('='));
    return {
      // ...原有其他配置
      globals: {
        // 将参数存入全局配置，自动透传到Worker
        __CLI_TEST_ARGS__: cliTestArgs
      }
    }
  }
  

  测试文件内读取示例：

  // one-big-test-suite.test.ts（运行在Worker进程）
  declare const __CLI_TEST_ARGS__: string[];
  console.log(__CLI_TEST_ARGS__) // 输出 ['one-big-test-suite', 'test-1']
  

• 方案2：通过环境变量透传参数
  Node.js fork的子进程会自动继承父进程的环境变量，你可以在执行jest命令时直接把需要读取的参数写入环境变量，不需要修改Jest配置，测试文件内通过process.env即可直接读取。
  示例执行命令：

  TEST_CLI_ARGS="one-big-test-suite,test-1" npx jest -c "..." one-big-test-suite test-1
  

  测试内读取：

  const args = process.env.TEST_CLI_ARGS.split(',')
  

• 方案3：通过自定义测试环境暴露Jest内置解析参数
  Jest会在主进程将CLI传入的所有测试匹配规则合并为testPathPattern正则配置，这个值会被传递给每个Worker的测试环境实例。你可以自定义测试环境，在初始化时把这个配置挂到全局对象上，测试文件内即可读取到完整的匹配规则，再通过正则解析得到所有传入的测试筛选值。

避坑提示 #

• 不要依赖Worker进程内的非公开内部全局变量（比如未文档化的Jest配置对象），这类值在不同Jest版本存在变动，没有长期兼容保障。
• 不要尝试从Worker进程反向连接主进程读取参数，这种方式会破坏Jest的沙箱隔离机制，容易触发安全校验报错。

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