The rejectionhandled event is sent to the script's global scope (usually window but also Worker) whenever a JavaScript Promise is rejected but after the promise rejection has been handled. This can be used in debugging and for general application resliency, in tandem with the unhandledrejection event, which is sent when a promise is rejected but there is no hander for the rejection.
| Bubbles | No |
|---|---|
| Cancelable | No |
| Interface | PromiseRejectionEvent |
| Event handler property | onrejectionhandled |
Example
You can use the rejectionhandled event to log promises that get rejected to the console, along with the reasons why they were rejected:
window.addEventListener("rejectionhandled", event => {
console.log("Promise rejected; reason: " + event.reason);
}, false);
Specifications
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard The definition of 'rejectionhandled' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
No compatibility data found. Please contribute data for "api.Window.rejectionhandled_event" (depth: 1) to the MDN compatibility data repository.
See also
Document Tags and Contributors
Tags:
Contributors to this page:
wbamberg,
mfuji09,
Sheppy,
mdnwebdocs-bot,
paul.irish,
chrisdavidmills,
fscholz
Last updated by:
wbamberg,