Cucumber JS步骤定义中正则提取序数对应数字的实现问题求助

问题根因 #

现有代码无法捕获到目标值的核心原因有两个：

• 正则规则没有对需要提取的数字片段设置普通捕获分组。Cucumber JS仅会将正则中普通捕获组匹配到的内容，作为入参传递给步骤回调；原规则是全量匹配'2nd'整段文本，没有拆分提取数字部分，因此回调函数里定义的element参数实际拿到的是undefined。
• 规则中写的(?:st|nd|rd|th)?属于非捕获组，仅负责匹配序数后缀文本，本身不会产生可传递的捕获值，也不会拆分提取数字内容。

可落地的修复实现 #

1. 调整正则规则：把需要提取的1-2位数字用普通圆括号()包裹成捕获组，序数后缀部分保留非捕获组匹配即可。
2. 回调函数按捕获组顺序接收参数，需要数值类型时手动做类型转换。

调整后的完整步骤定义代码：

// 正则改动：在数字部分外增加普通捕获括号()
When(/^I click the '(\d{1,2})(?:st|nd|rd|th)?' item in the list$/, async function(indexStr) {
    // 此时indexStr就是从'2nd'中捕获到的字符串"2"
    const targetIndex = Number(indexStr);
    await helperActions.clickTopBanksListElement(targetIndex);
});

注意事项 #

• 捕获组和回调参数按位置一一对应：第一个捕获组对应第一个回调参数，依次类推。不要把不需要的内容（比如st/nd这类序数后缀）放到捕获组中，否则捕获到的内容会带后缀文本，不是纯目标数字。
• 若正则全程没有任何普通捕获分组，Cucumber JS不会向回调函数传递任何匹配到的片段，这是这类捕获失效问题最常见的触发场景。
• 严格区分非捕获组和捕获组：只有不带?:前缀的圆括号，才是可被Cucumber JS识别、能产生回调参数的有效捕获分组。

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