如何在WebdriverIO中断言字符串为多个值之一？

方法1：直接用Chai的oneOf断言 #

WebdriverIO的expect基于Chai实现，Chai原生提供oneOf方法，可直接检查值是否属于指定数组，完美适配输入框getValue()返回的字符串：

const expectDOB_AU = '29/02/2024';
const expectDOB_US = '2/29/2024';
const actualDOB = await MyPage.inputDOB.getValue();

await expect(actualDOB).to.be.oneOf([expectDOB_AU, expectDOB_US]);

这是最简洁的方案，无需额外封装，适合简单场景。

方法2：封装自定义断言函数 #

如果需要后续扩展逻辑（比如添加格式校验、日志输出），可以封装一个复用性更强的函数：

function assertValueInList(actualValue, expectedList) {
    if (!expectedList.includes(actualValue)) {
        throw new Error(`实际值：${actualValue}，不在预期列表：${expectedList} 中`);
    }
}

// 使用示例
const expectDOB_AU = '29/02/2024';
const expectDOB_US = '2/29/2024';
const actualDOB = await MyPage.inputDOB.getValue();

assertValueInList(actualDOB, [expectDOB_AU, expectDOB_US]);

方法3：扩展WebdriverIO的Expect API #

如果项目中频繁需要这类断言，可以全局扩展Expect方法，统一代码风格：

// 在测试初始化文件（比如wdio.conf.js的before钩子）中添加扩展
before(() => {
    expect.extend({
        toBeOneOf(received, expected) {
            const pass = expected.includes(received);
            return {
                message: () => pass 
                    ? `预期${received}不在列表${expected}中（未触发）` 
                    : `实际值${received}不在预期列表${expected}中`,
                pass: pass
            };
        }
    });
});

// 测试用例中直接调用
const expectDOB_AU = '29/02/2024';
const expectDOB_US = '2/29/2024';
const actualDOB = await MyPage.inputDOB.getValue();

await expect(actualDOB).toBeOneOf([expectDOB_AU, expectDOB_US]);

补充说明 #

• hasText是WebdriverIO针对元素文本的封装断言，仅适用于元素的文本内容检查，无法直接适配输入框getValue()返回的字符串，所以需要用通用断言方案。
• 后续若要支持更多区域日期格式，只需扩展预期值数组即可，比如const expectedDOBs = ['29/02/2024', '2/29/2024', '2024-02-29']。

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