W3cubDocs

/DOM

WindowEventHandlers.onunhandledrejection

The Window.onunhandledrejection property is an event handler for processing unhandledrejection events, which are raised for unhandled Promise rejections.

Syntax

window.onunhandledrejection = EventHandler;

Value

An EventHandler or function to call when unhandledrejection events are received by the window. The event handler receives as an input parameter a PromiseRejectionEvent.

Examples

This example simply logs unhandled rejections' reason values to the console.

window.onunhandledrejection = function(e) {
  console.log(e.reason);
}

Specifications

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

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 49 Yes No
No
Firefox implements the PromiseRejectionEvent interface if you go to about:config and set the dom.promise_rejection_events.enabled pref to true. However, Firefox doesn't yet actually send the unhandledrejection or understand rejectionhandled events. Completing the implementation will be addressed in bug 1362272.
No No No
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support No No Yes No
No
Firefox implements the PromiseRejectionEvent interface if you go to about:config and set the dom.promise_rejection_events.enabled pref to true. However, Firefox doesn't yet actually send the unhandledrejection or understand rejectionhandled events. Completing the implementation will be addressed in bug 1362272.
No No ?

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WindowEventHandlers/onunhandledrejection