RSpec长示例多断言问题：--fail-fast未终止及截图时机疑问

先搞懂--fail-fast的实际作用 #

别误会，--fail-fast管的是整个测试套件：只要有任意一个测试用例（即it块）失败，整个测试进程直接终止，不会再运行后续的测试用例。但它管不了单个测试用例内部的多个断言——哪怕第一个断言失败，这个用例里的后续代码还是会继续执行，直到整个用例结束。

让单个测试用例内断言失败就立刻停止 #

要让单个用例里只要有一个断言失败就终止后续操作，直接在测试用例开头加个错误监听钩子即可：

// 放在测试用例的最开头
cy.on('fail', (error, runnable) => {
  throw error; // 一出错就抛出异常，强制停掉当前用例的所有后续代码
});

这样一来，第一个断言失败后，后面的步骤会直接终止，不会再出现“第一步失败还硬跑第二步”的情况。

让截图保留失败时的页面状态 #

默认情况下，Cypress会在每个失败的断言处自动截图，但如果后续代码继续执行（比如页面跳转、点击操作），后续的页面变化会覆盖之前的截图状态。用上一步的方法让用例在失败时立刻终止，Cypress就会保留断言失败那一刻的页面截图，不会变成测试结束时的状态。

要是担心自动截图不稳，也可以在关键断言前手动截图，确保拿到准确状态：

// 可选：在第一步断言前手动保存截图
cy.screenshot('注册第一步-初始状态');
expect(page).to.have.text('欢迎进入注册第一步');

额外配置：开启测试隔离避免状态污染 #

如果测试用例之间存在残留状态（比如上一个用例未清理的Cookie、本地存储），也可能导致执行逻辑混乱。可以在cypress.config.js中开启测试隔离：

module.exports = {
  e2e: {
    testIsolation: true, // 每个测试用例都会重置浏览器状态，实现彻底隔离
  },
};

内容的提问来源于stack exchange，提问作者Quentin Gaultier