如何在Jest中通过代码层面全局运行单个测试套件？

Jest 原生没有提供跨文件生效的全局.only()机制：你在单个测试文件内调用的.only()/.skip()方法，作用域严格限定在当前文件内，不会影响其他测试文件的执行逻辑。这是由Jest多worker隔离加载测试文件的运行架构决定的，既不存在顶层describe调用即可全局独占套件的原生方法，也不支持单文件写it.only()就全局跳过其他所有用例，这类跨文件筛选能力原生仅通过配置或CLI参数提供。

代码层面实现全局独占运行的方法 #

如果需要把独占标记直接写在测试代码中、不依赖手动输入CLI参数，可以通过全局初始化脚本实现自定义全局.only()能力：

• 第一步：给需要独占运行的套件/用例加自定义标记，比如：

  // 需要单独运行的测试文件内
  describe('[GLOBAL_ONLY] 订单模块测试套件', () => {
    test('创建订单逻辑校验', () => {
      // 测试逻辑
    })
  })
  

• 第二步：在Jest配置的setupFilesAfterEnv字段中添加全局初始化脚本，重写全局的describe、test/it方法：

  // jest.global-only.setup.js
  let existsGlobalOnlyTarget = false
  const originDescribe = global.describe
  const originTest = global.test
  
  // 重写describe实现套件级全局独占
  global.describe = (suiteName, ...args) => {
    if (suiteName.includes('[GLOBAL_ONLY]')) {
      existsGlobalOnlyTarget = true
      return originDescribe.only(suiteName, ...args)
    }
    return existsGlobalOnlyTarget ? originDescribe.skip(suiteName, ...args) : originDescribe(suiteName, ...args)
  }
  
  // 重写test/it实现用例级全局独占
  global.test = global.it = (caseName, ...args) => {
    if (caseName.includes('[GLOBAL_ONLY]')) {
      existsGlobalOnlyTarget = true
      return originTest.only(caseName, ...args)
    }
    return existsGlobalOnlyTarget ? originTest.skip(caseName, ...args) : originTest(caseName, ...args)
  }
  

• 注意：使用该方案时运行Jest需要加上--runInBand参数关闭多worker并行执行，保证全局标记在同一个上下文中同步，避免出现部分文件未被正确跳过的问题。

官方原生支持的筛选方案 #

如果不需要把独占标记硬编码在测试逻辑里，更稳定的方式是使用Jest原生提供的配置或CLI参数做筛选：

• 运行单个测试文件：直接在jest命令后传入目标文件路径即可，例如jest ./tests/order.test.js
• 全局运行名称匹配的测试用例：使用-t/--testNamePattern参数指定用例名称匹配规则，例如jest -t "创建订单逻辑校验"会全局执行所有名称匹配的用例
• 运行路径匹配的测试套件：使用--testPathPattern参数指定文件路径匹配正则
• 固定筛选规则：如果需要长期固定运行指定套件，可以直接在Jest配置文件中设置testMatch、testPathIgnorePatterns字段，过滤不需要运行的测试文件。

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