Cypress中contains()如何实现或逻辑匹配文本并执行点击

针对Cypress官方Docker镜像浏览器语言强制转英文的临时兼容问题，cy.contains()本身不支持直接传||做或逻辑匹配，可通过以下3种无依赖方案实现，不需要等官方修复镜像Bug：

方案1：正则表达式匹配（最简洁） #

cy.contains()原生支持传入正则作为匹配规则，直接把两个待匹配文本拼成正则的或表达式即可。如果文本里有正则特殊字符（比如.、?、(这类），提前做转义处理。
示例代码：

const value1 = data.text_local_language
const value2 = data.text_english
// 生成匹配任意一个值的正则，可按需加matchCase: false配置开启不区分大小写匹配
const matchReg = new RegExp(`^(${value1}|${value2})$`)

cy.get("element")
  .contains(matchReg)
  .click()

注：如果不需要精确全量匹配，去掉正则里的^和$即可实现包含匹配。

方案2：元素过滤（适配含特殊字符的文本） #

如果待匹配文本里有大量正则特殊字符、不想处理转义逻辑，可以先拿到父元素下的所有候选元素，再通过Cypress内置jQuery的.filter()方法筛出文本匹配任意一个目标值的元素。
示例代码：

const value1 = data.text_local_language
const value2 = data.text_english

cy.get("element")
  .filter((index, el) => {
    const text = Cypress.$(el).text().trim()
    return text === value1 || text === value2
  })
  .click()

注：如果要匹配父元素下的子元素，把.filter()换成.find()结合筛选逻辑即可。

方案3：运行环境预判（性能最优） #

可以在测试启动时先判断当前运行环境是本地还是Docker容器，直接选中对应环境的目标文本，不需要运行时做双重匹配。
示例代码：

const value1 = data.text_local_language
const value2 = data.text_english
// 判断是否运行在Docker环境，可根据自己的实际配置调整判断条件
const isDockerEnv = Cypress.env('runtime_env') === 'docker'
const targetText = isDockerEnv ? value2 : value1

cy.get("element")
  .contains(targetText)
  .click()

注意事项 #

• 上述方案默认做精确文本匹配，如果业务场景是部分文本包含匹配，把对应判断逻辑里的全等判断改成includes、正则去掉首尾锚点即可
• 匹配前建议对元素文本做.trim()处理，避免元素自带的换行、缩进空格导致匹配失败

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