使用全局错误处理器捕获 javascript 异步异常,核心在于同时监听 window 对象的 unhandledrejection 事件和 process.on('uncaughtexception')(node.js 环境)。浏览器端通过注册 addeventlistener('unhandledrejection', ...) 可以拦截未被 catch 处理的 promise 拒绝;服务端则需设置进程级异常捕获。这样做能防止程序因未处理错误而崩溃或静默失败,确保所有异步路径的异常都能被统一记录或上报。

浏览器中如何配置 unhandledrejection 监听器
在浏览器环境中,必须为 window 对象添加 unhandledrejection 事件监听器。该事件会在 Promise 被拒绝且没有对应的 catch 处理程序时触发。监听器接收一个包含 reason(拒绝原因)和 promise(被拒绝的 Promise 对象)的事件对象。调用 e.preventDefault() 可以阻止浏览器控制台输出默认的红色错误日志,从而避免干扰用户或污染控制台。

const globalErrorHandler = (event) => {
// 阻止默认的控制台报错
event.preventDefault();
const reason = event.reason;
console.error('Unhandled Rejection:', reason);
// 这里可以添加上报逻辑,例如:
// sendToMonitoringService(reason);
};
window.addEventListener('unhandledrejection', globalErrorHandler);
上述代码定义了一个名为 globalErrorHandler 的函数,并将其绑定到 window 的 unhandledrejection 事件上。当代码中出现类似 Promise.reject(new Error('Test')) 且未进行 catch 处理时,该监听器会被触发。预期结果是控制台打印出 'Unhandled Rejection: Error: Test',且不会显示浏览器默认的堆栈跟踪信息。这适用于单页应用(SPA)的全局异常监控。
立即学习“Java免费学习笔记(深入)”;
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
Node.js 服务端如何实现进程级异常捕获
在 Node.js 环境中,异步错误通常表现为未处理的 Promise 拒绝或未捕获的异常。对于未捕获的同步或异步异常(如回调风格中的错误),应使用 process.on('uncaughtException')。虽然 Node.js 官方不推荐在生产环境中依赖此机制来恢复程序状态,但它能防止进程立即崩溃,允许你执行清理操作或优雅退出。对于 Promise 拒绝,Node.js 15+ 版本默认会抛出 unhandledRejection 异常,因此也可以利用 uncaughtException 捕获,但更推荐使用 process.on('unhandledRejection') 进行专门处理。

process.on('uncaughtException', (error) => {
console.error('Uncaught Exception:', error);
// 执行必要的清理工作
cleanupResources();
// 建议退出进程,因为状态可能已不一致
process.exit(1);
});
process.on('unhandledRejection', (reason, promise) => {
console.error('Unhandled Rejection at:', promise, 'reason:', reason);
// 可以选择继续运行,但需记录日志
});
function cleanupResources() {
console.log('Cleaning up database connections...');
}
这段代码展示了如何在 Node.js 中设置两个关键的事件监听器。uncaughtException 用于捕获同步或异步抛出的错误,通常伴随进程退出逻辑以确保数据一致性。unhandledRejection 专门处理 Promise 拒绝。预期结果是当代码中发生未处理错误时,控制台会打印相应的错误信息,并执行清理函数。这种组合覆盖了 Node.js 应用中主要的异步错误场景。
如何处理特定输入下的 Promise 拒绝细节
当异步操作返回特定的错误对象或字符串时,全局处理器需要能够正确解析和展示这些信息。例如,如果 API 调用失败返回的是一个 JSON 格式的响应体,直接打印可能会显得杂乱。此时,可以在全局处理器中检查 reason 的类型,如果是对象,则提取其中的关键字段(如 message、status)进行格式化输出。这有助于在调试时快速定位问题根源,而不是面对一堆难以阅读的原始数据。

















