Jest跨测试套件传递变量失败问题排查

我来帮你把这个问题拆解明白——你第一个方案失效的核心，是没搞清楚Jest的代码执行顺序，先从你的问题说起，再给你讲透Jest的运行逻辑，最后给你不污染全局的解决思路。

为什么第一个方案会失败？ #

你第一个主测试文件里，foobar(foo)是直接写在describe块的顶层代码里的，而Jest执行代码分两个完全独立的阶段：收集阶段和执行阶段。

当Jest扫描到你的describe块时，会立刻同步执行foobar(foo)这行代码——这时候beforeAll钩子还根本没运行，foo还是初始声明的undefined。虽然foobar里注册了两个it测试用例，但这两个用例拿到的foo是收集阶段的undefined，后续beforeAll给foo赋值bar的时候，这两个测试用例的参数已经固定了，自然会失败。

Jest的完整执行流程 #

Jest的运行分为两个关键阶段，搞懂这个你就能避开绝大多数类似的坑：

1. 收集阶段

   • Jest会遍历所有测试文件，同步执行所有describe、it/test的顶层代码
   • 这个阶段的目的是注册所有测试用例和套件结构，不会执行任何测试钩子（beforeAll/beforeEach等），也不会执行it的回调函数（也就是你写断言的地方）
   • 简单说：这个阶段Jest只是“记下来”有哪些测试要跑，还没开始真正执行测试

2. 执行阶段

   • 当所有测试用例都收集完成后，Jest才会按层级执行测试：
     • 先执行当前测试套件的beforeAll钩子
     • 对每个it用例，先执行beforeEach，再执行it的回调函数（你的断言逻辑就在这里），最后执行afterEach
     • 所有用例跑完后，执行afterAll钩子

不污染全局的可行解决方案 #

既然不能把变量丢到全局，又要跨套件共享初始化后的变量，有几个实用的思路：

方案1：用闭包封装共享变量和初始化逻辑 #

可以把共享变量和初始化逻辑封装在一个独立模块里，通过闭包来访问变量，避免全局污染：

// shared-foo.js
let foo;

// 导出初始化钩子
export const setupFoo = () => {
  beforeAll(() => {
    foo = 'bar';
  });
};

// 导出获取变量的方法
export const getFoo = () => foo;

然后在主测试文件里调用初始化，套件文件里通过getFoo()拿到最新值：

// 主测试文件
import { setupFoo, getFoo } from './shared-foo';
import { foobar } from './foobar';

// 初始化共享变量
setupFoo();

describe('foo is bar', () => {
  it('should be defined', () => foobar(getFoo()));
  it('should be bar', () => expect(getFoo()).toMatch('bar'));
});

// 测试套件文件
export const foobar = (foo) => expect(foo).toBeDefined();

方案2：继续优化你修改后的方案（最简洁） #

你修改后的方案其实已经很合理了——把断言逻辑封装成函数，在it的回调里调用它。因为it的回调是在执行阶段才会运行，这时候beforeAll已经完成了变量初始化，能拿到正确的foo值。如果有多个测试套件需要复用，只要在每个套件的it里传入初始化后的变量就行，完全不需要全局变量。

总结 #

核心原则就是：不要在收集阶段（比如describe顶层）使用依赖钩子初始化的变量，所有需要用到初始化后变量的逻辑，都要放在it/test的回调函数里，或者通过闭包、模块导出的函数来获取变量，这样就能避开Jest执行顺序带来的坑。

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