/DOM Events


The unhandledrejection event is fired when a JavaScript Promise is rejected but there is no rejection handler to deal with the rejection.

Bubbles No
Cancelable Yes
Target objects defaultView
Interface PromiseRejectionEvent


The unhandledrejection event implements the PromiseRejectionEvent interface, which inherits from Event. You can use the properties and methods defined on these interfaces.


Simple Reporting

window.addEventListener("unhandledrejection", function (event) {
    console.warn("WARNING: Unhandled promise rejection. Shame on you! Reason: "
                 + event.reason);

Preventing Default

Many environments report unhandled promise rejections to the console by default. The event is cancelable, and so preventDefault prevents that default action:

window.addEventListener("unhandledrejection", function (event) {
    // ...your code here to handle the unhandled rejection...

    // Prevent the default handling (error in console)


Specification Status Comment
HTML Living Standard
The definition of 'unhandledrejection' in that specification.
Living Standard Initial definition.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 49 No support No support No support No support
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support No support No support No support No support No support

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.