events: graduate capturerejections to supported

These have been around long enough to warrant graduation.

Signed-off-by: James M Snell <jasnell@gmail.com>

PR-URL: https://github.com/nodejs/node/pull/41267
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
This commit is contained in:
James M Snell authored and GitHub committed 2021-12-27 14:14:35 +00:00
1 parent 59db172827
commit 9a85efaa7f
1 file changed
+14 -10
+14 -10
View File
@@ -173,8 +173,6 @@ myEmitter.emit('error', new Error('whoops!'));
## Capture rejections of promises
> Stability: 1 - captureRejections is experimental.
Using `async` functions with event handlers is problematic, because it
can lead to an unhandled rejection in case of a thrown exception:
@@ -741,10 +739,12 @@ emitter.emit('log');
added:
- v13.4.0
- v12.16.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/41267
description: No longer experimental.
-->
> Stability: 1 - captureRejections is experimental.
* `err` Error
* `eventName` {string|symbol}
* `...args` {any}
@@ -1028,10 +1028,12 @@ foo().then(() => console.log('done'));
added:
- v13.4.0
- v12.16.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/41267
description: No longer experimental.
-->
> Stability: 1 - captureRejections is experimental.
Value: {boolean}
Change the default `captureRejections` option on all new `EventEmitter` objects.
@@ -1040,12 +1042,14 @@ Change the default `captureRejections` option on all new `EventEmitter` objects.
<!-- YAML
added:
- v13.4.0
- v12.16.0
- v13.4.0
- v12.16.0
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/41267
description: No longer experimental.
-->
> Stability: 1 - captureRejections is experimental.
Value: `Symbol.for('nodejs.rejection')`
See how to write a custom [rejection handler][rejection].