如何在Cypress断言失败时暂停测试运行器？

要实现断言失败才暂停测试，有两种可行的方式：

方案1：监听全局fail事件 #

Cypress的断言失败会触发全局fail事件，我们可以在这个事件里调用cy.pause()，同时保留原错误让测试正常标记失败：

// 可以在单个测试用例内添加，也可以在cypress/support/index.js里全局配置
Cypress.on('fail', (error, runnable) => {
  cy.pause();
  // 重新抛出错误，保证测试结果正确上报
  throw error;
});

// 执行你的断言
cy.get('.target-element').should('have.value', '预期值');

如果只想让这个逻辑作用于某一段断言，避免影响其他测试，可以临时绑定再解绑事件：

const handleFail = (error, runnable) => {
  cy.pause();
  throw error;
};

// 绑定事件
Cypress.on('fail', handleFail);

// 目标断言
cy.get('.target-element').should('have.value', '预期值');

// 解绑事件
Cypress.off('fail', handleFail);

方案2：手动断言+条件暂停 #

放弃cy.should()的链式写法，用cy.then()手动判断断言条件，失败时主动暂停并抛出错误：

cy.get('.target-element').then($el => {
  const actual = $el.val();
  const expected = '预期值';
  
  if (actual !== expected) {
    cy.pause();
    throw new Error(`断言失败：实际值是 "${actual}"，预期是 "${expected}"`);
  }
});

为什么你之前的方法没用？ #

• cy.should().pause()：不管断言成功还是失败，都会执行pause，达不到“仅失败时暂停”的目的。
• try/catch捕获：Cypress命令是异步队列执行的，cy.should()的错误不会同步抛出，而是在队列执行阶段才触发，所以try/catch抓不到。
• 监听uncaught:exception：断言失败属于Cypress的测试错误，不是页面的未捕获JS异常，所以这个事件不会被触发。

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