如何在特定场景下跳过Cypress测试文件中的全部测试用例？

方法一：基于页面元素判断，在钩子中跳过整个测试上下文 #

如果你的判断逻辑依赖页面中的DOM元素（比如示例里的div[title='OK']），可以通过修改钩子函数的上下文来实现：

context("Conditional run", function() {
  before(function() {
    cy.get("div").then($div => {
      // 检查目标元素是否存在
      const shouldSkip = Cypress.$("div[title='OK']", $div).length > 0;
      if (shouldSkip) {
        this.skip(); // 跳过当前context下的所有测试用例
      }
    });
  });

  it("测试用例1", () => {
    cy.log("执行测试逻辑1");
  });

  it("测试用例2", () => {
    cy.log("执行测试逻辑2");
  });
});

关键说明：

• 把context和before的箭头函数改成普通函数，这样this才能指向当前的测试上下文，调用this.skip()就能直接跳过整个context下的所有测试用例。
• 当满足跳过条件时，Cypress会自动标记该上下文下的所有测试为「skipped」状态，不会执行后续测试逻辑。

方法二：基于前置条件（如环境变量）提前跳过 #

如果判断逻辑不依赖页面元素（比如根据环境变量、配置值），可以在文件顶部直接做条件判断：

// 比如根据环境变量决定是否跳过
const shouldSkipAll = Cypress.env('SKIP_THIS_SUITE') === 'yes';

if (shouldSkipAll) {
  context("Conditional run", () => {
    it.skip("该测试套件已跳过", () => {});
  });
} else {
  context("Conditional run", () => {
    before(() => {
      // 正常的前置操作
    });

    it("测试用例1", () => {
      // 测试逻辑
    });
  });
}

注意事项：

• 依赖DOM元素的判断必须放在before或beforeEach钩子中，因为Cypress的DOM操作是异步的，无法在文件顶部同步执行。
• 使用this.skip()时，绝对不能用箭头函数定义钩子，否则会丢失测试上下文，导致无法调用该方法。

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