Cypress使用contains匹配同文本元素时长度断言为1如何解决

.contains()是Cypress的单元素定位命令，核心逻辑是从之前链式调用拿到的元素集合里，返回第一个匹配目标文本的元素，无论之前的查询命中了多少个符合选择器的元素，.contains()最终只会返回0个（无匹配结果）或者1个（命中第一个符合文本要求的元素）元素，永远不会返回多个元素。
你提供的测试脚本实际执行逻辑是：先查询到页面上所有div元素，再从这批div里挑出第一个文本为some text的元素，最后对这个仅包含1个元素的结果集做长度为2的断言，必然会触发报错。

根据实际场景选择以下任意一种写法即可：

• 直接在选择器中使用:contains伪类做筛选，一次性获取所有匹配目标文本的元素

const selector = 'div'
const text = 'some text'

cy.get(`${selector}:contains("${text}")`)
  .should('have.length', 2);

• 先查询到所有符合基础选择器的元素，再通过.filter()方法过滤出匹配文本的元素，这种写法逻辑更清晰，是多元素筛选场景下的推荐写法

const selector = 'div'
const text = 'some text'

cy.get(selector)
  .filter(`:contains("${text}")`)
  .should('have.length', 2);

• 如果需要做精确的完全文本匹配（避免元素文本仅包含目标字符串、并非完全相等的误判），可以给.filter()传入自定义匹配逻辑

const selector = 'div'
const text = 'some text'

cy.get(selector)
  .filter((index, el) => el.textContent.trim() === text)
  .should('have.length', 2);

补充说明：.contains()命令本身是为单元素交互场景设计的，比如点击某个带指定文本的按钮、定位单个输入框这类场景用它非常便捷，但只要涉及统计同文本元素数量、批量操作同文本元素的场景，都不要直接在元素集合后链式调用.contains()。

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