如何让Mocha框架按顺序执行测试用例而非并行执行？

场景代码示例 #

用户当前使用Mocha的测试代码结构如下：

// ...
const { describe } = require("mocha");
// ...

describe("Description1", function(){
   describe("Description2", function(){
      it("Description2", function(){
               // 测试逻辑...
      });
   });
   // ...
   describe("Description10", function(){
      it("Description10", function(){
               // 测试逻辑...
      });
   });
});

用户遇到的问题：Mocha会并行执行所有it()测试用例，需要配置为每个it()在上一个测试用例完成后再启动（即串行执行）。

解决方法 #

Mocha 默认就是串行执行测试用例的，若出现并行执行的情况，通常是开启了并行运行配置，按以下方式关闭即可：

• 命令行方式：运行测试时，去掉--parallel参数，或者明确添加--no-parallel强制关闭并行：

  mocha --no-parallel your-test-file.js
  

• 配置文件方式：如果使用了Mocha配置文件（如.mocharc.js、.mocharc.json），将parallel选项设为false：

  // .mocharc.js
  module.exports = {
    parallel: false,
    // 其他测试配置
  };
  

额外提示 #

如果测试用例之间存在依赖（比如共享全局状态），虽然串行执行能满足需求，但更推荐让每个测试用例保持独立，通过beforeEach/afterEach等钩子函数隔离测试环境，避免测试结果互相干扰。

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