PromiseRejectionEvent

The PromiseRejectionEvent interface represents events which are fired when JavaScript Promises are rejected. These events are particularly useful for telemetry and debugging purposes.

Constructor

PromiseRejectionEvent()

Creates a PromiseRejectionEvent event with the given parameters.

Properties

Also inherits properties from its parent Event.

PromiseRejectionEvent.promise Read only

The JavaScript Promise that was rejected.

PromiseRejectionEvent.reason Read only

A value or Object indicating why the promise was rejected, as passed to Promise.reject().

Methods

This interface has no unique methods; inherits methods from its parent Event.

Events

unhandledrejection

Fired when a JavaScript Promise is rejected but there is no rejection handler to deal with the rejection.

rejectionhandled

Fired when a JavaScript Promise is rejected, and after the rejection is handled by the promise's rejection handling code.

Examples

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

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See also

• Promise
• WindowEventHandlers.onrejectionhandled
• WindowEventHandlers.onunhandledrejection