Cypress如何配置全局basic auth，无需每次调用cy.visit时传auth参数

1. 配置环境对应授权信息 #

在cypress.config.js（Cypress 10+版本）中按环境绑定baseUrl和auth凭据，示例配置如下：

const { defineConfig } = require("cypress");

module.exports = defineConfig({
  env: {
    // 开发环境配置
    development: {
      baseUrl: "http://dev.your-domain.com",
      auth: {
        username: "dev_account",
        password: "dev_password"
      }
    },
    // 测试环境配置
    staging: {
      baseUrl: "http://staging.your-domain.com",
      auth: {
        username: "staging_account",
        password: "staging_password"
      }
    },
    // 可扩展其他环境
    production: {
      baseUrl: "https://your-domain.com",
      auth: null
    }
  },
  e2e: {
    setupNodeEvents(on, config) {
      // 启动时指定运行环境，默认使用开发环境
      const runEnv = config.env.runEnv || "development";
      // 把对应环境的配置挂载到全局
      config.baseUrl = config.env[runEnv].baseUrl;
      config.env.auth = config.env[runEnv].auth;
      return config;
    },
  },
});

启动测试时可通过参数切换环境：npx cypress open --env runEnv=staging

2. 全局覆盖cy.visit自动注入auth #

在全局支持文件cypress/support/e2e.js中添加以下代码，重写visit默认逻辑：

// 保存原生visit方法
const originalVisit = cy.visit;
// 重写命令自动注入auth
Cypress.Commands.overwrite("visit", (originalFn, url, options = {}) => {
  const globalAuth = Cypress.env("auth");
  // 全局配置了auth且用户未手动传入auth时自动注入
  if (globalAuth && !options.auth) {
    options.auth = globalAuth;
  }
  return originalFn(url, options);
});

注意：如果你使用的是Cypress 9及更早版本，配置文件对应修改为cypress.json，全局支持文件对应修改为cypress/support/index.js即可，逻辑完全一致。

3. 测试用例直接调用 #

后续测试代码中直接写cy.visit("/")即可自动带上对应环境的basic auth，无需额外传参。如果有特殊场景需要自定义auth，手动传入auth参数就会覆盖全局配置，不会产生冲突。

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