捕获未处理的Promise错误

译者按: 经过监听unhandledrejection事件,能够捕获未处理的Promise错误。javascript

为了保证可读性,本文采用意译而非直译,而且对源代码进行了大量修改。另外,本文版权归原做者全部,翻译仅用于学习。html

使用Promise编写异步代码时,使用reject来处理错误。有时,开发者一般会忽略这一点,致使一些错误没有获得处理。例如:java

function main() {
    asyncFunc()
    .then(···)
    .then(() => console.log('Done!'));
}

因为没有使用catch方法捕获错误,当asyncFunc()函数reject时,抛出的错误则没有被处理。node

这篇博客将分别介绍在浏览器与Node.js中,如何捕获那些未处理的Promise错误。git

浏览器中未处理的Promise错误

一些浏览器(例如Chrome)可以捕获未处理的Promise错误。github

unhandledrejection

监听unhandledrejection事件,便可捕获到未处理的Promise错误:chrome

window.addEventListener('unhandledrejection', event => ···);

这个事件是PromiseRejectionEvent实例,它有2个最重要的属性:小程序

  • promise: reject的Promise
  • reason: Promise的reject值

示例代码:微信小程序

window.addEventListener('unhandledrejection', event =>
{
    console.log(event.reason); // 打印"Hello, Fundebug!"
});

function foo()
{
    Promise.reject('Hello, Fundebug!');
}

foo();

FundebugJavaScript错误监控插件监听了unhandledrejection事件,所以能够自动捕获未处理Promise错误。api

rejectionhandled

当一个Promise错误最初未被处理,可是稍后又获得了处理,则会触发rejectionhandled事件:

window.addEventListener('rejectionhandled', event => ···);

这个事件是PromiseRejectionEvent实例。

示例代码:

window.addEventListener('unhandledrejection', event =>
{
    console.log(event.reason); // 打印"Hello, Fundebug!"
});

window.addEventListener('rejectionhandled', event =>
{
    console.log('rejection handled'); // 1秒后打印"rejection handled"
});


function foo()
{
    return Promise.reject('Hello, Fundebug!');
}

var r = foo();

setTimeout(() =>
{
    r.catch(e =>{});
}, 1000);

Node.js中未处理的Promise错误

监听unhandledRejection事件,便可捕获到未处理的Promise错误:

process.on('unhandledRejection', (reason, promise) => ···);

示例代码:

process.on('unhandledRejection', reason =>
{
    console.log(reason); // 打印"Hello, Fundebug!"
});

function foo()
{
    Promise.reject('Hello, Fundebug!');
}

foo();

注: Node.js v6.6.0+ 默认会报告未处理的Promise错误,所以不去监听unhandledrejection事件也没问题。

FundebugNode.js错误监控插件监听了unhandledRejection事件,所以能够自动捕获未处理Promise错误。

参考

关于Fundebug

Fundebug专一于JavaScript、微信小程序、微信小游戏、支付宝小程序、React Native、Node.js和Java线上应用实时BUG监控。 自从2016年双十一正式上线,Fundebug累计处理了10亿+错误事件,付费客户有Google、360、金山软件、百姓网等众多品牌企业。欢迎你们免费试用

版权声明

转载时请注明做者Fundebug以及本文地址:
https://blog.fundebug.com/2017/10/09/unhandled-pomise-rejection/

相关文章
相关标签/搜索