如何在CodeceptJS场景触发前执行异步函数并传递数据至Data()钩子

核心原因 #

CodeceptJS的Data()钩子是在测试文件加载阶段执行的，而Before()、BeforeSuite()这类运行时钩子是在测试执行阶段才触发，所以你之前尝试的所有钩子都会晚于Data()执行，自然无法传递数据。

解决方案 #

利用顶层异步执行（ES模块）或立即执行异步函数（CommonJS），在测试文件加载时先完成数据获取，再初始化Data()和测试用例：

情况1：使用ES模块（推荐，Node 14.8+支持）

// 顶层await直接获取测试数据
const testData = await fetch('你的测试数据接口地址')
  .then(res => res.json())
  .catch(err => {
    console.error('获取测试数据失败:', err);
    throw err; // 终止测试，避免使用无效数据
  });

// 用获取到的数据初始化Data钩子
Data(testData);

Feature('动态数据测试');

Scenario('验证数据驱动场景', ({ I }) => {
  // 直接使用currentData访问当前测试数据
  I.amOnPage('/login');
  I.fillField('账号', currentData.account);
  I.fillField('密码', currentData.password);
  I.click('登录');
  I.see('欢迎登录');
});

情况2：使用CommonJS（兼容旧版Node）

// 用立即执行异步函数包裹，确保数据先获取完成
(async () => {
  const testData = await fetch('你的测试数据接口地址')
    .then(res => res.json())
    .catch(err => {
      console.error('获取测试数据失败:', err);
      throw err;
    });

  Data(testData);

  Feature('动态数据测试');

  Scenario('验证数据驱动场景', ({ I }) => {
    I.amOnPage('/login');
    I.fillField('账号', currentData.account);
    I.fillField('密码', currentData.password);
    I.click('登录');
    I.see('欢迎登录');
  });
})();

注意事项 #

• 如果是Node环境，Node 18+内置fetch，低版本需要安装node-fetch包（v2版本适配CommonJS，v3适配ES模块）。
• 必须处理数据获取失败的情况，避免测试用例使用无效数据运行。
• 如果testData是数组，Data()会自动遍历每个元素生成独立的测试用例，和常规用法一致。

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