mirror of
https://github.com/nodejs/node.git
synced 2024-12-01 16:10:02 +01:00
523a1550a3
The emit{Before,After} APIs in AsyncResource are problematic.
* emit{Before,After} are named to suggest that the only thing they do
is emit the before and after hooks. However, they in fact, mutate
the current execution context.
* They must be properly nested. Failure to do so by user code leads
to catastrophic (unrecoverable) exceptions. It is very easy for the
users to forget that they must be using a try/finally block around
the code that must be surrounded by these operations. Even the
example provided in the official docs makes this mistake. Failing
to use a finally can lead to a catastrophic crash if the callback
ends up throwing.
This change provides a safer `runInAsyncScope` API as an alternative
and deprecates emit{Before,After}.
PR-URL: https://github.com/nodejs/node/pull/18513
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Andreas Madsen <amwebdk@gmail.com>
|
||
|---|---|---|
| .. | ||
| _toc.md | ||
| addons.md | ||
| all.md | ||
| assert.md | ||
| async_hooks.md | ||
| buffer.md | ||
| child_process.md | ||
| cli.md | ||
| cluster.md | ||
| console.md | ||
| crypto.md | ||
| debugger.md | ||
| deprecations.md | ||
| dgram.md | ||
| dns.md | ||
| documentation.md | ||
| domain.md | ||
| errors.md | ||
| esm.md | ||
| events.md | ||
| fs.md | ||
| globals.md | ||
| http2.md | ||
| http.md | ||
| https.md | ||
| index.md | ||
| inspector.md | ||
| intl.md | ||
| modules.md | ||
| n-api.md | ||
| net.md | ||
| os.md | ||
| path.md | ||
| perf_hooks.md | ||
| process.md | ||
| punycode.md | ||
| querystring.md | ||
| readline.md | ||
| repl.md | ||
| stream.md | ||
| string_decoder.md | ||
| synopsis.md | ||
| timers.md | ||
| tls.md | ||
| tracing.md | ||
| tty.md | ||
| url.md | ||
| util.md | ||
| v8.md | ||
| vm.md | ||
| zlib.md | ||