如何通过编程方式终止Cypress测试？runner.stop()未生效

你遇到的问题是因为Cypress的执行机制是异步命令队列，同步调用Cypress.runner.stop()无法阻止已经被加入队列的命令，而且同步代码（比如console.log("Visiting...")）会在测试启动时优先执行，导致即使调用了stop，这些代码依然会运行。

以下是两种无需大量if语句的解决方案：

方案1：利用断言失败自动终止测试 #

直接通过should('exist')断言元素存在，一旦断言失败，测试会立即终止，后续代码不会执行：

describe("Basic test", () => {
  it.only("First test", () => {
    cy.visit("http://localhost:9999");
    cy.pause();
    
    // 检查重要元素是否存在，不存在则直接终止测试
    cy.get("#importantBox").should("exist");
    
    // 只有元素存在时，才会执行以下代码
    cy.log("Visiting..."); // 用cy.log代替console.log，确保在命令队列中执行
    cy.visit("http://localhost:9999/page1");
  });
});

注意：这里用cy.log替代console.log，因为console.log是同步代码，会在测试初期就执行，而cy.log是Cypress命令，会加入队列，只有前面的断言通过后才会运行。

方案2：主动抛出错误终止测试 #

如果需要自定义终止时的错误信息，可以结合fail()方法：

describe("Basic test", () => {
  it.only("First test", () => {
    cy.visit("http://localhost:9999");
    cy.pause();
    
    cy.get("#importantBox")
      .should("exist")
      .fail("重要元素不存在，测试终止");
    
    cy.log("Visiting...");
    cy.visit("http://localhost:9999/page1");
  });
});

当should("exist")断言失败时，fail()会抛出自定义错误，测试随即终止，后续命令不会执行。

为什么原来的方法无效？ #

你之前的代码中，Cypress.runner.stop()是同步调用，而后续的console.log和cy.visit是同步代码和已加入队列的命令。Cypress的runner.stop()只能阻止队列中未开始执行的命令，但同步代码会优先执行，所以会看到"Stopping..."和"Visiting..."都被打印。只有将逻辑融入Cypress的异步命令队列（比如用then、断言），才能正确控制测试流程。

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