Cypress是否内置API支持cy.request间隔重试轮询逻辑

Cypress 没有提供专门用于固定间隔轮询的独立API，但依托内置的命令自动重试能力，无需手写递归定时器、无需引入第三方插件，就可以实现你需要的「每3秒拉取一次、最长等待2分钟」的逻辑，比手写定时逻辑更符合Cypress的执行时序规范，不会出现异步变量错乱的问题。

原有代码的问题 #

你当前的写法存在两个明显问题：

• cy.request默认只会执行1次，不会判断返回结果中是否存在目标邮件，也不会自动重试
• 用外部声明的let emailContent变量存储请求结果，很容易因为Cypress命令的异步入队特性出现时序问题，拿到空值

可直接使用的实现代码 #

it('Should be able to reset password', () => {
  // 轮询配置：重试间隔3秒，总超时时间2分钟
  const POLL_INTERVAL = 3000;
  const MAX_WAIT_TIME = 120000;

  // 拉取邮件的核心逻辑
  const fetchEmailContent = () => {
    // 每次请求前等待固定间隔
    return cy.wait(POLL_INTERVAL).request(
      'GET',
      `https://api.testmail.app/api/json?apikey=${TestMailService.APIKEY}&namespace=${TestMailService.NAMESPACE}&tag=test&livequery=true`
    ).then((response) => {
      // 校验是否拿到有效邮件，未拿到则抛出错误触发重试
      if (!response.body.emails?.[0]?.text) {
        throw new Error('密码重置邮件未送达，准备重试');
      }
      return response.body.emails[0].text;
    })
  }

  // 启动轮询：超时时间内只要抛出错误就自动重跑逻辑，直到拿到有效内容或超时
  cy.wrap(null, { timeout: MAX_WAIT_TIME })
    .then(() => fetchEmailContent())
    .should('not.be.empty')
    .then((emailContent) => {
      // 此处即可拿到有效的邮件正文，后续密码重置测试逻辑直接写在这里
      // 不要用外部变量存emailContent，所有依赖该值的逻辑都要放在这个then回调里
    })
})

实现原理说明 #

• Cypress 所有带断言的命令链都自带重试能力：只要链路上的断言未通过、或者回调中抛出了错误，Cypress就会在设定的超时时间内，重新执行断言之前的所有命令逻辑
• 给cy.wrap设置2分钟的超时时间，就相当于给整个轮询流程设置了总等待上限
• 在请求前加固定的cy.wait(3000)，即可实现每3秒发起一次拉取的间隔要求
• 业务校验不通过时主动抛错，是触发Cypress自动重试的核心条件

注：如果不希望第一次请求前等待3秒，可以给fetchEmailContent加个首次调用的标记，第一次跳过wait即可，对整体流程影响极小。

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