diff options
| author | Chengzhong Wu <chengzhong.wcz@alibaba-inc.com> | 2022-09-13 11:29:10 +0300 |
|---|---|---|
| committer | Juan José Arboleda <soyjuanarbol@gmail.com> | 2022-10-11 22:45:30 +0300 |
| commit | adae66cbd47fb05652606ae9538cd15cf6966763 (patch) | |
| tree | 602c29c84bdf2084bf562eb35b7133a32abac9de /doc | |
| parent | 7e07cce24ba554110709da46b20cf0c446c2871c (diff) | |
node-api: add deprecation code of uncaught exception
Deprecation should reference a valid deprecation code.
PR-URL: https://github.com/nodejs/node/pull/44624
Refs: https://github.com/nodejs/node/pull/36510
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Reviewed-By: Michael Dawson <midawson@redhat.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/api/deprecations.md | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index e7c931bef47..adeea95c501 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -3153,6 +3153,8 @@ Type: Documentation-only The [`--trace-atomics-wait`][] flag is deprecated. +<!-- md-lint skip-deprecation DEP0166 --> + ### DEP0167: Weak `DiffieHellmanGroup` instances (`modp1`, `modp2`, `modp5`) <!-- YAML @@ -3171,12 +3173,34 @@ details. These groups might be removed in future versions of Node.js. Applications that rely on these groups should evaluate using stronger MODP groups instead. +### DEP0168: Unhandled exception in Node-API callbacks + +<!-- YAML +changes: + - version: + - v18.3.0 + - v16.17.0 + pr-url: https://github.com/nodejs/node/pull/36510 + description: Runtime deprecation. +--> + +Type: Runtime. + +The implicit suppression of uncaught exceptions in Node-API callbacks is now +deprecated. + +Set the flag [`--force-node-api-uncaught-exceptions-policy`][] to force Node.js +to emit an [`'uncaughtException'`][] event if the exception is not handled in +Node-API callbacks. + [Legacy URL API]: url.md#legacy-url-api [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3 [RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4 [WHATWG URL API]: url.md#the-whatwg-url-api [`"exports"` or `"main"` entry]: packages.md#main-entry-point-export +[`'uncaughtException'`]: process.md#event-uncaughtexception +[`--force-node-api-uncaught-exceptions-policy`]: cli.md#--force-node-api-uncaught-exceptions-policy [`--pending-deprecation`]: cli.md#--pending-deprecation [`--throw-deprecation`]: cli.md#--throw-deprecation [`--trace-atomics-wait`]: cli.md#--trace-atomics-wait |