如何在不运行测试时统计Jest测试函数总数及查询相关源码

核心逻辑定位 #

Jest的测试发现与用例统计逻辑主要分散在几个核心包中，你可以重点关注以下部分：

1. 默认测试运行器jest-circus的收集逻辑 #

Jest默认使用jest-circus作为测试运行器，测试用例的注册与收集逻辑在这个包内：

• 测试函数（test/it）的注册入口：jest-circus包下的setupTestFrameworkScriptFile.js，这里会把test/it等方法挂载到全局上下文，每调用一次就会向测试套件中添加一个用例。
• 测试用例的统计实现：jest-circus的testScheduler.js里的getTests方法，会递归遍历所有测试套件（describe块），统计其中的测试用例总数。

2. Jest CLI的前置统计逻辑 #

在jest-cli包的runTests.js文件中，Jest在执行测试前会先收集所有测试用例并统计数量，这里调用了jest-circus的collectTests方法，你可以参考这部分代码的实现逻辑。

复用逻辑的可行方案 #

如果不想执行测试只统计数量，可以通过模拟Jest的测试环境，解析测试文件并拦截test/it的调用：

基于Jest内部模块的实现示例 #

const { ScriptTransformer } = require('jest-runtime');
const { getTestPaths } = require('jest-config');
const vm = require('vm');
const path = require('path');

// 加载项目的Jest配置
const config = require(path.resolve(process.cwd(), 'jest.config.js'));

async function countTests() {
  const testFiles = await getTestPaths(config);
  const transformer = new ScriptTransformer(config);
  
  let totalTests = 0;

  // 模拟Jest全局环境，拦截测试函数调用
  const mockGlobal = {
    test: () => totalTests++,
    it: () => totalTests++,
    describe: (_, fn) => fn(), // 执行describe块内的代码
    beforeEach: () => {},
    afterEach: () => {},
    expect: () => ({ toBe: () => {} }),
    // 根据项目需要添加其他Jest全局方法的模拟
  };

  for (const file of testFiles) {
    try {
      const transformedCode = await transformer.transform(file);
      vm.runInNewContext(transformedCode, mockGlobal);
    } catch (e) {
      console.warn(`Failed to process file: ${file}`, e.message);
    }
  }

  return totalTests;
}

countTests().then(total => console.log(`Total tests: ${total}`));

注意事项 #

• 这种方案依赖Jest的私有API，版本更新可能导致代码失效，建议锁定Jest版本或根据新版本调整实现。
• 如果项目使用的是jest-jasmine2而非默认的jest-circus，需要调整模拟逻辑以适配Jasmine的测试注册方式。

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