在WebdriverIO配置中为Browserstack Capabilities添加测试用例名称

要让Browserstack显示正确的测试用例名称，你可以通过以下几种方式修改Capabilities中的name字段：

方式1：执行命令时直接传入环境变量 #

你当前配置里的name: process.env.TEST_NAME是通过环境变量获取名称，只需在执行测试命令时带上TEST_NAME变量即可：

TEST_NAME="登录功能测试" wdio ./config/wdio.ios.browserstack.conf.js --spec ./path/to/spec.js

这样Browserstack就会将该测试会话的名称设为你指定的内容。

方式2：动态设置当前测试用例名称 #

如果想自动获取测试代码里it块的标题作为Browserstack显示的名称，可以在WDIO配置文件中添加beforeTest钩子，动态更新会话名称：

// 在你的wdio.ios.browserstack.conf.js中添加以下配置
exports.config = {
  // ... 其他原有配置 ...
  beforeTest(test, context) {
    // 调用Browserstack的executor接口设置当前测试用例名称
    browser.executeScript('browserstack_executor: {"action": "setSessionName", "arguments": {"name": "' + test.title + '"}}');
  },
  // ... 其他原有配置 ...
  capabilities: [{
    project: "My project",
    build: `Build Number`,
    name: process.env.TEST_NAME || "默认测试名称", // 保留环境变量作为兜底选项
    device: 'iPhone 11 Pro',
    os_version: "15",
    maxInstances: 1,
    app: process.env.BROWSERSTACK_APP_ID,
    deviceOrientation: 'portrait',
    'appium.noReset': true,
    'browserstack.debug': true,
    "appium.newCommandTimeout": 1000, 
    'appium.xcodeOrgId': 'SomeID',
    'appium.xcodeSigningId': 'iPhone Developer',
    'appium.automationName': 'XCUITest',
  }]
};

这种方式会在每个测试用例执行前，自动将Browserstack会话名更新为当前it块的标题，无需手动在命令行传参。

方式3：从spec文件路径提取名称（可选） #

如果想基于spec文件的名称来设置测试名称，可以在配置初始化时解析spec路径：

const path = require('path');

// 从命令行参数中提取当前执行的spec文件路径
const specArgIndex = process.argv.indexOf('--spec');
const specFile = specArgIndex !== -1 ? process.argv[specArgIndex + 1] : null;
const testName = specFile ? path.basename(specFile, '.js') : '默认测试名称';

config.capabilities = [{
  project: "My project",
  build: `Build Number`,
  name: testName, // 替换为解析后的文件名
  // ... 其他原有capabilities配置 ...
}];

这种方式适合按文件划分测试用例的场景，直接用文件名作为测试会话名称。

内容的提问来源于stack exchange，提问作者Jairo Rodríguez