简介
@bugsnag/plugin-node-unhandled-rejection是一个Node.js模块，提供了一个可插拔的Bugsnag实现，它能自动捕获Node.js的未处理的Promise rejection并自动上传到Bugsnag服务器，从而实现快速的错误监控与自动化异常处理。同时，这个npm包也可以自定义一些操作来处理自定义的异常情况。在本文中，我们会介绍如何快速使用这个npm包。
安装
可以通过npm命令行工具进行安装：
$ npm install @bugsnag/plugin-node-unhandled-rejection --save
使用教程
使用@bugsnag/plugin-node-unhandled-rejection很容易，您只需要按照以下简单的步骤进行操作即可。
配置您的Bugsnag账户
首先，请确保您已经在Bugsnag.com上创建了帐户。如果没有，请先去创建Bugsnag帐户。
创建配置文件
在您的项目中，创建一个名为bugsnag.js的文件，它将保存有关您的Bugsnag配置信息的所有内容。在这个文件中，您需要提供以下信息：
const { Client } = require('@bugsnag/core');
module.exports = new Client({
apiKey: 'YOUR_API_KEY_HERE',
});首先，我们导入了@bugsnag/core模块。这个模块中包含了一些核心的Bugsnag客户端实现，比如日志记录器和面板。然后，我们创造了一个Bugsnag客户端实例，它将我们的API密钥传递给Bugsnag。您可以在Bugsnag Dashboard中找到API KEY。确保将YOUR_API_KEY_HERE替换为您的实际API密钥。
Register Unhandled error listener
下一步，我们需要向Node.js添加一个未处理的reject侦听器，以便可以自动捕获未处理的Promise rejection。为此，我们需要执行以下操作：
const { register } = require('@bugsnag/plugin-node-unhandled-rejection');
const bugsnagClient = require('./bugsnag');
register(bugsnagClient, options);在这里，我们首先导入了@bugsnag/plugin-node-unhandled-rejection模块。该模块提供了多个不同的方法，可用于不同的Bugsnag客户端实现。然后，我们从bugsnag.js导入了bugsnagClient对象，它将包含有关我们的API密钥的信息。接下来，我们调用了register方法，并将Bugsnag客户端实例传递给它，以便Bugsnag系统可以处理未处理的Promise rejection。
Customizing the Unhandled Rejection Event
通过这种方式，您可以侦听未处理的rejected事件，这意味着可以自动捕获未处理的Promise rejection。但是，如果您希望更多地控制这个事件，那么您可以使用自定义处理程序。为了自定义处理程序，您需要做以下两个操作：
- 创建一个函数，该函数将在未处理的拒绝事件发生时调用。
function customHandler(err, promise) {
// Your custom error handling logic here
}2.在注册时使用自定义处理程序。
const { register } = require('@bugsnag/plugin-node-unhandled-rejection')
const bugsnagClient = require('./bugsnag')
const options = {
onUnHandledRejectionHandled: customHandler
}
register(bugsnagClient, options);示例代码
-- -------------------- ---- ------- ----- - -------- - - --------------------------------------------------- ----- ------------- - -------------------- -------- ------------------ -------- - -- ---- ------ ----- -------- ----- ---- - ----- ------- - - ---------------------------- ------------- - ----------------------- ---------
总结
在本文中，我们介绍了如何使用@bugsnag/plugin-node-unhandled-rejection来自动捕获未处理的Promise rejection，并将它们上传到Bugsnag服务器。我们还介绍了如何自定义未处理的拒绝事件处理程序，并提供了示例代码。如果您在使用中遇到了任何问题或有任何建议，请随时与我们联系!
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/bugsnag-plugin-node-unhandled-rejection