Cypress是否默认等待请求？如何配置默认等待所有XHR请求完成

嘿，这个问题太贴合实际场景了——慢应用加一堆API调用，一个个写cy.wait()真的烦死人！我来给你拆解清楚，再给几个实用的解决方案：

首先明确：Cypress本身不会默认等待所有XHR/fetch请求完成。它的默认等待逻辑主要是针对DOM元素的——比如你用cy.get()找元素时，它会默认等4秒（可配置）直到元素出现。

不过有个例外：如果你提前给某个请求加了别名（比如cy.intercept('/api/user').as('getUser')），然后用cy.wait('@getUser')，那它会专门等这个请求完成。但这是主动指定的等待，不是全局自动的。

针对你说的“每个API单独写语句太繁琐”的问题，这里有几个可落地的方案：

方案1：全局拦截+自定义命令（最推荐） #

你可以在Cypress的支持文件（一般是cypress/support/e2e.js）里配置全局的请求拦截和等待逻辑，然后封装成自定义命令，不用每个测试都重复写。

步骤如下：

1. 先在全局维护一个数组，用来追踪未完成的请求
2. 拦截所有需要等待的API请求（建议过滤路径，避免把轮询、静态资源请求也加进来）
3. 监听请求的发起和完成事件，更新数组
4. 封装一个自定义命令，用来等待数组里所有请求完成

示例代码：

// cypress/support/e2e.js
let pendingApiRequests = [];

// 只拦截/api开头的请求，根据你的实际路径调整
cy.intercept('/api/**').as('apiRequest');

// 请求发起时，加入待处理数组
cy.on('request:before:send', (req) => {
  if (req.alias === 'apiRequest' && !pendingApiRequests.includes(req.alias)) {
    pendingApiRequests.push(req.alias);
  }
});

// 请求完成后，从数组移除
cy.on('request:after:response', (req) => {
  const index = pendingApiRequests.indexOf(req.alias);
  if (index !== -1) {
    pendingApiRequests.splice(index, 1);
  }
});

// 自定义命令：等待所有API请求完成
Cypress.Commands.add('waitForAllApi', () => {
  return cy.wrap(null).then(() => {
    if (pendingApiRequests.length > 0) {
      return cy.wait(pendingApiRequests).then(() => {
        pendingApiRequests = []; // 清空数组，避免影响下一个测试
      });
    }
  });
});

之后你就可以在测试里随便用了：

// 比如在每个测试步骤前自动等待
beforeEach(() => {
  cy.waitForAllApi();
});

// 或者在某个操作后等待
cy.click('#submit-button');
cy.waitForAllApi(); // 等所有提交后的API请求完成再继续

⚠️ 注意：一定要过滤请求路径！如果把轮询请求（比如每隔3秒请求一次的接口）也加进来，测试会一直等待，永远完不成。

方案2：用时钟控制定时请求（针对轮询场景） #

如果你的应用有定时轮询的API调用，比如每隔5秒拉一次数据，那可以用cy.clock()冻结时间，再用cy.tick()快进时间，让轮询请求触发并完成，避免等待真实时间。

示例代码：

// 冻结时间
cy.clock();

// 执行操作，比如打开页面
cy.visit('/dashboard');

// 快进6秒，让轮询请求触发并完成
cy.tick(6000);

// 等待所有API请求完成
cy.wait('@apiRequest');

// 恢复时间，不影响后续测试
cy.clock().invoke('restore');

方案3：调整全局超时（被动兜底） #

这个方法不是主动等待请求，但可以给Cypress更长的超时时间，让它在执行命令时更“有耐心”。在cypress.config.js里修改：

module.exports = {
  e2e: {
    defaultCommandTimeout: 10000, // 把默认命令超时从4秒改成10秒
    requestTimeout: 10000, // 请求超时时间
    responseTimeout: 10000 // 响应超时时间
  }
};

不过这个是被动等待，不如主动等待请求完成可靠，适合作为兜底方案。

全局等待所有请求虽然方便，但一定要注意排除不需要等待的请求（比如websocket、静态资源、轮询接口），不然很容易导致测试挂起失败。如果有部分请求不需要等待，直接在拦截时过滤掉路径就行。

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