MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

PromiseRejectionEvent.promise

The PromiseRejectionEvent interface's promise read-only property indicates the JavaScript Promise which was rejected. You can examine the event's PromiseRejectionEvent.reason property to learn why the promise was rejected.

Syntax

promise = PromiseRejectionEvent.promise

Value

The JavaScript Promise which was rejection, and whose rejection went unhandled.

Examples

This example listens for unhandled promises and, if the reason is an object with a code field containing the text "Module not ready", it sets up an idle callback that will retry the task that failed to execute correctly.

event.preventDefault() is called to indicate that the promise has now been handled.

window.onunhandledrejection = function(event) {
  if (event.reason.code && event.reason.code == "Module not ready") {
    window.requestIdleCallback(function(deadline) {
      loadModule(event.reason.moduleName)
        .then(performStartup);
    });
    event.preventDefault();
  }
}

Specifications

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

Browser compatibility

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

[1] In Firefox, this is implemented but disabled by default. To turn it on, go to about:config and set the dom.promise_rejection_events.enabled pref to true.

See also

Document Tags and Contributors

 Contributors to this page: Sheppy, chrisdavidmills, fscholz
 Last updated by: Sheppy,