为什么Cypress中搭配await使用cy.wait不生效？如何避免每个it块重复写cy.wait？

1. await 写法失效原因 #

• Cypress 的命令执行基于全局队列机制，所有cy开头的命令都会按声明顺序加入队列自动串行执行，返回的是Cypress专属的Chainer对象，不是标准Promise，直接用await调用无法触发预期的等待逻辑
• 你提供的示例中it的回调函数没有标注async关键字，本身就不支持内部使用await语法，即便加上async修饰，也会和Cypress内置的队列调度逻辑冲突，导致执行顺序混乱

额外注意：你给出的示例代码中cy.intercept没有调用.as()方法设置别名，实际使用时需要补充设置才能通过@别名捕获对应请求，示例如下：

cy.intercept("/users", {
  fixture: "users.json", // fixture值为字符串，需要加引号
}).as("firstApiCall")

2. 避免每个it块重复编写cy.wait的方案 #

方案1：将等待逻辑放入beforeEach #

如果当前测试集所有用例都依赖这些接口返回，可以直接在beforeEach的页面访问后加上等待逻辑，所有用例执行时接口已经加载完成，无需单独写等待：

describe("some page", () => {
  beforeEach(() => {
    cy.intercept("/users", {
      fixture: "users.json",
    }).as("firstApiCall");
    cy.intercept("/other-api", {
      fixture: "other.json",
    }).as("2ndApiCall");
    cy.visit("/somewhere");
    // 同时等待多个请求，不需要嵌套then
    cy.wait(["@firstApiCall", "@2ndApiCall"]);
  });

  it("show something", () => {
    cy.get("test:something").should("exist");
  });

  it("show other element", () => {
    cy.get("test:other").should("be.visible");
  });
});

方案2：封装自定义Cypress命令 #

如果只有部分用例需要等待这些接口，可以将等待逻辑封装为自定义命令，全局可用：
首先在cypress/support/commands.js中添加定义：

Cypress.Commands.add('waitForPageRequiredApis', () => {
  return cy.wait(["@firstApiCall", "@2ndApiCall"]);
})

用例中直接调用即可：

it("show something", () => {
  cy.waitForPageRequiredApis();
  cy.get("test:something").should("exist");
});

方案3：封装公共访问函数 #

如果多个测试文件都用到同一份页面访问+接口等待逻辑，可以封装为公共函数导入使用：

// 公共工具文件 utils/cypress.js
export const visitSomePageWithApis = () => {
  cy.intercept("/users", {fixture: "users.json"}).as("firstApiCall");
  cy.intercept("/other-api", {fixture: "other.json"}).as("2ndApiCall");
  cy.visit("/somewhere");
  return cy.wait(["@firstApiCall", "@2ndApiCall"]);
}

// 测试文件中使用
import { visitSomePageWithApis } from 'utils/cypress'
describe("some page", () => {
  beforeEach(() => {
    visitSomePageWithApis();
  });
  // 用例直接编写断言即可
})

额外提示：如果需要等待同一个别名的请求触发多次，可以直接使用cy.wait('@firstApiCall', {times: 2})，不需要重复编写两次cy.wait。

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