Skip to content

Commit

Permalink
events: graduate capturerejections to supported
Browse files Browse the repository at this point in the history
These have been around long enough to warrant graduation.

Signed-off-by: James M Snell <[email protected]>

PR-URL: #41267
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Antoine du Hamel <[email protected]>
  • Loading branch information
jasnell authored and targos committed Jan 14, 2022
1 parent e339220 commit 4079fc4
Showing 1 changed file with 14 additions and 10 deletions.
24 changes: 14 additions & 10 deletions doc/api/events.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down Expand Up @@ -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}
Expand Down Expand Up @@ -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.
Expand All @@ -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].
Expand Down

0 comments on commit 4079fc4

Please sign in to comment.