如何通过WDIO的AllureReporter与Mocha设置Allure报告用例参数

1. 你当前的用法错误点 #

• allureReporter.addEnvironment("staging") 用法错误：这个方法需要传入键值对两个参数，比如allureReporter.addEnvironment("environment", "staging")，单传一个值不会生效。
• allureReporter.addArgument("browserType", "Firefox") 语法本身没问题，但如果没生效，大概率是调用时机不对（比如在测试执行完成后才调用）或者版本不兼容。

2. 正确的参数设置方法 #

方法一：用WDIO配置文件直接定义环境信息 #

在wdio.conf.js的reporters配置中，直接通过environmentInfo字段预设所有需要的参数，测试启动时会自动同步到Allure报告：

reporters: [
    ['allure', {
        environmentInfo: {
            browser: 'Firefox',
            browserVersion: '115.0',
            mode: 'headless',
            environment: 'staging'
        },
        // 其他Allure配置项
    }]
]

方法二：动态获取浏览器信息并添加 #

借助WDIO的browser对象获取当前运行的浏览器实际参数，在测试钩子中动态添加到Allure报告：

beforeTest(async () => {
    // 获取浏览器基础信息
    const { browserName, browserVersion } = await browser.capabilities;
    // 判断是否为无头模式（不同浏览器参数名不同）
    const isHeadless = await browser.capabilities['moz:headless'] || 
                      (await browser.capabilities['goog:chromeOptions']?.args.includes('--headless'));

    // 添加到Allure环境信息
    allureReporter.addEnvironment("Browser", browserName);
    allureReporter.addEnvironment("Browser Version", browserVersion);
    allureReporter.addEnvironment("Run Mode", isHeadless ? "Headless" : "Normal");
    // 添加用例参数
    allureReporter.addArgument("Test Env", "staging");
});

方法三：使用Allure环境属性文件 #

在项目的allure-results目录下创建environment.properties文件，直接写入键值对，Allure会自动读取并显示在报告中：

browser=Firefox
browserVersion=115.0
mode=headless
environment=staging

注意事项 #

• 确保WDIO与AllureReporter的版本兼容，版本不匹配可能导致API失效；
• addEnvironment和addArgument需要在测试执行阶段（如beforeTest、测试用例内部）调用，测试结束后调用不会生效。

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