Cypress如何为Page Object内的login方法单独配置重试规则

开发者阿泽

2026-9-30

登录逻辑内置重试实现方案

实现思路

直接在Login类的login方法内部封装递归重试逻辑，临时捕获登录失败的断言错误，次数未耗尽时自动刷新页面重试，次数耗尽再抛出错误，完全不需要修改上层调用代码也不需要配置全局重试。

完整代码实现

修改后的Login.js代码如下：

//Login.js
export class Login {
  username_input = () => cy.get('#LoginForm_username');
  password_input = () => cy.get('#LoginForm_password');
  login_button = () => cy.contains('Login');
  profile = () => cy.get('.profile-content');

  /**
   * 带重试的登录方法
   * @param {string} email 登录邮箱
   * @param {string} password 登录密码
   * @param {number} maxRetries 最大重试次数，默认2次（加上首次调用最多执行3次登录）
   * @param {number} retryDelay 重试前等待间隔，单位毫秒，默认1000ms
   * @returns {Login} 实例本身支持链式调用
   */
  login(email, password, maxRetries = 2, retryDelay = 1000) {
    // 清空输入框避免残留内容
    this.username_input().clear();
    this.password_input().clear();

    // 执行登录操作
    this.username_input().type(email);
    this.password_input().type(password);
    this.login_button().click();

    // 临时捕获本次登录的失败事件
    cy.once('fail', (err) => {
      // 重试次数耗尽直接抛出原始错误
      if (maxRetries <= 0) throw err;
      // 等待后刷新页面重试，重试次数减1
      cy.wait(retryDelay);
      cy.reload();
      return this.login(email, password, maxRetries - 1, retryDelay);
    })

    // 登录成功断言
    this.profile().should('exist');
    return this;
  }
}