TestCafe 3.6.0：测试文件无法获取动态项目配置的问题

问题场景 #

每次测试运行前需要创建新环境实例，设置唯一的项目配置（如baseUrl、apiUrl等），希望该配置在所有测试文件、fixture本地钩子、测试体中全局可用。当前已实现：

• 定义projectConfig.js模块存储配置并提供修改方法
• 在TestCafe runner启动前调用setConfig设置环境配置

但仅全局钩子（testRun.before、test.before）能获取到正确配置，测试文件、fixture本地钩子及测试体中获取到的配置为空字符串，导致页面无法正常打开。

问题原因 #

TestCafe的测试代码与runner代码运行在独立的进程中：

• runner进程中修改的模块级变量（projectConfig.js里的config对象）无法跨进程共享
• 测试文件import的projectConfig.js是测试进程重新加载的模块，保持初始空值状态

可行解决方案 #

方案1：使用自定义环境变量传递配置 #

在runner中通过环境变量注入配置，测试文件直接读取process.env：

1. 修改runner.js，将配置转为环境变量：

(async () => {
    const newConfig = {
        apiUrl: 'http://localhost:3000',
        baseUrl: 'http://localhost:3001',
        baseUrl2: 'http://localhost:3002',
    };

    // 将配置注入环境变量
    Object.entries(newConfig).forEach(([key, value]) => {
        process.env[`TESTCAFE_${key.toUpperCase()}`] = value;
    });

    const testcafe = await createTestCafe();
    const runner = testcafe.createRunner()
    // ... 后续runner配置
})();

2. 创建projectConfig.js读取环境变量：

export default {
    apiUrl: process.env.TESTCAFE_APIURL || '',
    baseUrl: process.env.TESTCAFE_BASEURL || '',
    baseUrl2: process.env.TESTCAFE_BASEURL2 || ''
};

3. 测试文件/fixture钩子中直接import使用：

import config from './projectConfig.js';

fixture('测试示例')
    .beforeEach(async t => {
        // 直接使用config，能拿到正确值
        await t.navigateTo(config.baseUrl);
    });

test('测试页面加载', async t => {
    await t.expect(Selector('title').innerText).eql('测试页面');
});

方案2：动态生成临时配置文件 #

runner先生成包含当前环境配置的文件，测试文件import该临时文件：

1. 修改runner.js，动态生成配置文件：

const fs = require('fs').promises;

(async () => {
    const newConfig = {
        apiUrl: 'http://localhost:3000',
        baseUrl: 'http://localhost:3001',
        baseUrl2: 'http://localhost:3002',
    };

    // 生成临时配置文件
    await fs.writeFile('./tempProjectConfig.js', `
        export default ${JSON.stringify(newConfig)};
    `);

    const testcafe = await createTestCafe();
    const runner = testcafe.createRunner()
    // ... 后续runner配置

    // 测试结束后删除临时文件（可选）
    process.on('exit', async () => {
        await fs.unlink('./tempProjectConfig.js').catch(() => {});
    });
})();

2. 测试文件中import临时配置：

import config from './tempProjectConfig.js';

fixture('测试示例')
    .beforeEach(async t => {
        await t.navigateTo(config.baseUrl);
    });

方案3：使用TestCafe的测试上下文传递（适合小范围传递） #

如果只需要在测试流程中传递，可通过testRun.before全局钩子将配置存入测试上下文，再在fixture/测试中读取：

1. 全局钩子中设置上下文：

// 在全局钩子文件中
import { testRun } from 'testcafe';
import config from './projectConfig.js';

testRun.before(async () => {
    testRun.testContext.projectConfig = config;
});

2. fixture钩子/测试体中读取：

fixture('测试示例')
    .beforeEach(async t => {
        const config = t.testRun.testContext.projectConfig;
        await t.navigateTo(config.baseUrl);
    });

test('测试接口', async t => {
    const config = t.testRun.testContext.projectConfig;
    const response = await fetch(`${config.apiUrl}/data`);
    // ... 断言逻辑
});

推荐方案 #

优先选择方案1（环境变量），无需额外文件操作，符合TestCafe跨进程数据传递的设计逻辑；如果配置结构复杂，方案2（动态生成配置文件）也是可靠选择。

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