Cypress等待页面指定文本出现问题：waitUntil插件使用异常求助

问题背景 #

需求为等待页面出现指定文本，未出现则重载页面重试，最长等待时长3分钟。现有基于cy.waitUntil插件的代码存在问题：contains方法执行失败后直接退出流程，未触发页面重载；且页面元素高度动态，无法使用固定元素定位。

原代码：

cy.waitUntil(
  () =>
    cy.get("tr").find("td").contains("mysampletext").reload(true),
  {
    verbose: true,
    errorMsg: "Campaign status failing to synchronize with clickhouse",
    timeout: 180000,
    interval: 30000,
  }
);

问题分析 #

原代码的核心问题是：Cypress命令链在contains匹配失败时会直接抛出未捕获的错误，终止整个测试流程，导致waitUntil的重试逻辑无法触发。同时，waitUntil的回调需要返回布尔值或Promise来判断是否继续重试，原代码的命令链无法正确传递重试状态。

解决方案 #

调整回调逻辑，通过catch捕获contains的失败，手动触发页面重载并返回false让waitUntil继续重试；成功匹配文本时返回true结束等待。代码示例：

cy.waitUntil(() => {
  return cy.get('tr').find('td')
    .contains('mysampletext')
    .then(() => {
      // 找到目标文本，返回true终止等待
      return true;
    })
    .catch(() => {
      // 未找到文本，重载页面后返回false继续重试
      cy.reload(true);
      return false;
    });
}, {
  verbose: true,
  errorMsg: "Campaign status failing to synchronize with clickhouse",
  timeout: 180000,
  interval: 30000,
});

补充说明 #

• 可选优化：给cy.get添加短超时（如cy.get('tr', { timeout: 3000 })），避免单次元素查找等待过久，提升重试效率。
• 选择器适配：若tr/td层级不稳定，可尝试基于页面结构的相对选择器（如带有测试ID的容器cy.get('[data-testid="data-table"]').find('tr td')），尽量提升选择器的鲁棒性。
• cy.reload(true)为强制重载，会绕过浏览器缓存，适合需要获取最新数据的场景。

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