From 4079fc42b7e84fd0e020436b60cea0594f844673 Mon Sep 17 00:00:00 2001 From: James M Snell Date: Mon, 27 Dec 2021 06:14:35 -0800 Subject: [PATCH] events: graduate capturerejections to supported These have been around long enough to warrant graduation. Signed-off-by: James M Snell PR-URL: https://github.com/nodejs/node/pull/41267 Reviewed-By: Matteo Collina Reviewed-By: Antoine du Hamel --- doc/api/events.md | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/doc/api/events.md b/doc/api/events.md index 71846ea4527edf..817099643e2ba4 100644 --- a/doc/api/events.md +++ b/doc/api/events.md @@ -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. -> Stability: 1 - captureRejections is experimental. - Value: `Symbol.for('nodejs.rejection')` See how to write a custom [rejection handler][rejection].