监听 promise.reject 未处理异常,核心方法是调用全局 api process.on('unhandledrejection', callback)。该事件会在 promise 被拒绝且没有任何 .catch() 或 try...catch 块捕获时触发,回调函数会接收错误对象和对应的 promise 实例作为参数。

Node.js 环境下的 unhandledRejection 事件
在 Node.js 中,process 对象提供了 unhandledRejection 事件来专门处理此类情况。当 Promise 进入 rejected 状态且未被捕获时,Node.js 引擎会抛出此事件。开发者可以在应用启动初期注册监听器,以便记录日志、上报监控或执行清理操作。

const process = require('process');
// 注册未处理拒绝的监听器
process.on('unhandledRejection', (reason, promise) => {
console.error('未处理的 Promise 拒绝:', reason);
console.log('关联的 Promise 对象:', promise);
});
// 模拟一个未处理的拒绝
Promise.reject(new Error('测试错误'));
// 保持进程运行以观察输出
setTimeout(() => {}, 1000);
运行上述代码,控制台将打印出“未处理的 Promise 拒绝: [Error: 测试错误]”以及关联的 Promise 对象信息。这证实了 process.on 能够准确捕获到未被 catch 链处理的拒绝状态。
浏览器环境下的 window.unhandledrejection 事件
在浏览器环境中,全局对象是 window(或在 Web Worker 中为 self),监听机制通过 window.addEventListener 绑定 unhandledrejection 事件来实现。与 Node.js 类似,当 Promise 被拒绝且没有相应的错误处理器时,浏览器会触发此事件。事件对象包含 promise 属性和 reason 属性,分别对应被拒绝的 Promise 实例和拒绝原因。
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。

// 浏览器环境示例
window.addEventListener('unhandledrejection', function(event) {
event.preventDefault(); // 阻止默认的控制台报错行为
console.error('浏览器中未处理的 Promise 拒绝:', event.reason);
console.log('关联的 Promise:', event.promise);
});
// 模拟一个未处理的拒绝
Promise.reject(new Error('浏览器测试错误'));
在浏览器控制台中运行此代码,可以看到自定义的错误日志输出,同时由于调用了 event.preventDefault(),浏览器默认的红色错误提示将被抑制。这展示了如何在不同前端环境中统一处理未捕获的 Promise 异常。
已处理拒绝与未处理拒绝的区别验证
为了明确 unhandledRejection 的触发条件,需要对比已处理和未处理两种情况。如果 Promise 被拒绝后紧接着使用了 .catch() 或 await try...catch,则视为已处理,不会触发未处理拒绝事件。只有当拒绝状态一直向上传播直到没有处理器为止,才会触发该事件。
// 已处理的情况:不会触发 unhandledRejection
Promise.reject(new Error('已处理错误'))
.catch(err => console.log('已捕获:', err.message));
// 未处理的情况:会触发 unhandledRejection
Promise.reject(new Error('未处理错误'));
第一段代码中的 .catch() 捕获了错误,因此 unhandledRejection 不会被触发。第二段代码没有后续的错误处理,因此会触发监听器。这种区别确保了只有在真正发生“漏捕”异常时才进行干预,避免对正常业务逻辑中的错误处理造成干扰。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










