Mocha如何及为何抑制未处理Promise拒绝？如何禁用该特性？

Node.js中出现未处理的Promise拒绝时，默认会终止进程，报错信息如下：

node:internal/process/promises:288
            triggerUncaughtException(err, true /* fromPromise */);
            ^

[UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "argh".] {
  code: 'ERR_UNHANDLED_REJECTION'
}

Node.js v18.17.1

但在Mocha测试中，这个终止行为不会触发。比如下面的测试代码：

it('test', () => {
  Promise.reject('argh')
})

测试结果显示用例直接通过：

√ test

  1 passing (3ms)

我查看了Mocha源码，知道它通过process.addEventListener('unhandledRejection', ...)监听该事件，处理函数中会移除自身监听并重发事件——理论上这应该触发Node.js的默认行为，但实际没生效，也没找到相关文档说明。

问题： #

1. Mocha是如何抑制未处理Promise拒绝的？为何要这么做？这是一个Bug吗？
2. 是否有办法配置Mocha停止该行为？

解答 #

1. Mocha抑制行为的方式、原因及是否为Bug #

Mocha是通过延迟检查+追踪Promise生命周期来抑制默认行为的：

• 它会在每个测试用例的执行周期里，维护一个Promise追踪列表。当测试用例执行完毕返回时，Mocha不会立刻处理未处理的Promise拒绝，而是等待一小段时间，看是否有后续的.catch()被绑定到这个Promise上。
• 它的unhandledRejection事件处理函数会先捕获拒绝，把对应的Promise标记为"待检查"，然后移除自身监听并重发事件——但此时Node.js的默认终止逻辑已经错过了触发时机，因为Mocha会在测试结束前清理这些待处理的拒绝，或者将其关联到后续的测试钩子中。

这么做是刻意的设计，不是Bug：目的是兼容异步测试的编写习惯——很多开发者会在测试里创建Promise，之后通过done回调、async/await或者后续钩子来处理它，如果立刻触发Node.js的终止行为，会导致大量合法的异步测试被误判失败。

2. 配置Mocha停止该行为的方法 #

有两种方式可以让Mocha遵循Node.js的默认未处理Promise拒绝行为：

• 命令行参数：执行测试时添加--unhandled-rejections=strict参数，强制Mocha对未处理的Promise拒绝直接抛出错误，触发Node.js的终止逻辑：

  mocha your-test-file.js --unhandled-rejections=strict
  

• 配置文件设置：如果使用.mocharc.js等配置文件，添加如下配置项：

  module.exports = {
    unhandledRejections: 'strict'
  }
  

启用该配置后，你的测试用例会因未处理的Promise拒绝而失败，同时触发Node.js的默认终止行为，就能复现需要测试的Bug场景。

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