node-unhandled-rejection/implementation-details.md

Trivia

• Some APIs use unhandledRejection, some use unhandledrejection. Note the capitalization difference.
• WhenJS is basically completely broken in bundled environments. It doesn't seem like this will be fixed any time soon...
• Bluebird claims that you should use self.addEventListener in a WebWorker context, but that does not actually appear to work - instead, I've used self.onunhandledrejection, which definitely does work.
• Due to the subtle differences between implementations, and the fact that different libraries respond differently to having both the modern and legacy event handler defined, you actually need to deduplicate errors to handle all rejections correctly.
• Some events come in a wrapper object. Some do not.
• What a mess...

Implementation chart (according to the documentation and specs, at least...)

Bluebird (http://bluebirdjs.com/docs/api/error-management-configuration.html#global-rejection-events)

• process.on//unhandledRejection: (Node.js) Potentially unhandled rejection.
• process.on//rejectionHandled: (Node.js) Cancel unhandled rejection, it was handled anyway.
• self.addEventListener//unhandledrejection: (WebWorkers) Potentially unhandled rejection.
• self.addEventListener//rejectionhandled: (WebWorkers) Cancel unhandled rejection, it was handled anyway.
• window.addEventListener//unhandledrejection: (Modern browsers, IE >= 9) Potentially unhandled rejection.
• window.addEventListener//rejectionhandled: (Modern browsers, IE >= 9) Cancel unhandled rejection, it was handled anyway.
• window.onunhandledrejection: (IE >= 6) Potentially unhandled rejection.
• window.onrejectionhandled: (IE >= 6) Cancel unhandled rejection, it was handled anyway.

WhenJS (https://github.com/cujojs/when/blob/3.7.0/docs/debug-api.md)

• process.on//unhandledRejection: (Node.js) Potentially unhandled rejection.
• process.on//rejectionHandled: (Node.js) Cancel unhandled rejection, it was handled anyway.
• self.addEventListener//unhandledrejection: (WebWorkers, Modern browsers, IE >= 9) Potentially unhandled rejection.
• self.addEventListener//rejectionhandled: (WebWorkers, Modern browsers, IE >= 9) Cancel unhandled rejection, it was handled anyway.

Spec (https://gist.github.com/benjamingr/0237932cee84712951a2)

• process.on//unhandledRejection: (Node.js) Potentially unhandled rejection.
• process.on//rejectionHandled: (Node.js) Cancel unhandled rejection, it was handled anyway.

Q (e01d7b2875/q.js (L1037-L1113))

• process.on//unhandledRejection: (Node.js) Potentially unhandled rejection.
• process.on//rejectionHandled: (Node.js) Cancel unhandled rejection, it was handled anyway.

Spec (WHATWG: https://html.spec.whatwg.org/multipage/webappapis.html#unhandled-promise-rejections)

• <browsingContext>.addEventListener//unhandledrejection: (Browsers, WebWorkers) Potentially unhandled rejection.
• <browsingContext>.addEventListener//rejectionhandled: (Browsers, WebWorkers) Cancel unhandled rejection, it was handled anyway.
• window.onunhandledrejection: (Browsers) Potentially unhandled rejection.
• window.onrejectionhandled: (Browsers) Cancel unhandled rejection, it was handled anyway.

ES6 Promises in Node.js (https://nodejs.org/api/process.html#process_event_rejectionhandled onwards)

• process.on//unhandledRejection: Potentially unhandled rejection.
• process.on//rejectionHandled: Cancel unhandled rejection, it was handled anyway.

Yaku (https://github.com/ysmood/yaku#unhandled-rejection)

• process.on//unhandledRejection: (Node.js) Potentially unhandled rejection.
• process.on//rejectionHandled: (Node.js) Cancel unhandled rejection, it was handled anyway.
• window.onunhandledrejection: (Browsers) Potentially unhandled rejection.
• window.onrejectionhandled: (Browsers) Cancel unhandled rejection, it was handled anyway.

then/promise

• Currently not implemented. (issue)

es6-promise

• Currently not implemented. (issue)