diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index fc333e937d6..9922a1ccfac 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -3921,6 +3921,9 @@ The `assert.CallTracker` API has been removed. -Type: Runtime +Type: Deprecation revoked -Calling [`util.promisify`][] on a function that returns a `Promise` will ignore -the result of said promise, which can lead to unhandled promise rejections. +Calling [`util.promisify`][] on a function that returns a `Promise` used to +ignore the result of said promise, which could lead to unhandled promise +rejections. The deprecation was revoked because this is a likely mistake rather +than use of a deprecated API. Rejections of the returned `Promise` are now +forwarded to the promise returned by the promisified function, and a regular +process warning with the code `PROMISIFY_RETURNED_PROMISE` is emitted instead. ### DEP0175: `util.toUSVString` diff --git a/doc/api/util.md b/doc/api/util.md index c30831019d0..63c3e42d371 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -2567,6 +2567,12 @@ parseEnv('HELLO=world\nHELLO=oh my\n');