mirror of
https://github.com/nodejs/node.git
synced 2026-11-09 15:11:11 -05:00
doc: discourage error event
PR-URL: https://github.com/nodejs/node/pull/37264 Refs: https://github.com/nodejs/node/pull/37237 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: Rich Trott <rtrott@gmail.com>
This commit is contained in:
1 parent
295e766c27
commit
cf5f6af8d6
1 file changed
+14
-5
+14
-5
@@ -1247,12 +1247,21 @@ target.addEventListener('foo', handler4, { once: true });
|
||||
### `EventTarget` error handling
|
||||
|
||||
When a registered event listener throws (or returns a Promise that rejects),
|
||||
by default the error is forwarded to the `process.on('error')` event
|
||||
on `process.nextTick()`. Throwing within an event listener will *not* stop
|
||||
the other registered handlers from being invoked.
|
||||
by default the error is treated as an uncaught exception on
|
||||
`process.nextTick()`. This means uncaught exceptions in `EventTarget`s will
|
||||
terminate the Node.js process by default.
|
||||
|
||||
The `EventTarget` does not implement any special default handling for
|
||||
`'error'` type events.
|
||||
Throwing within an event listener will *not* stop the other registered handlers
|
||||
from being invoked.
|
||||
|
||||
The `EventTarget` does not implement any special default handling for `'error'`
|
||||
type events like `EventEmitter`.
|
||||
|
||||
Currently errors are first forwarded to the `process.on('error')` event
|
||||
before reaching `process.on('uncaughtException')`. This behavior is
|
||||
deprecated and will change in a future release to align `EventTarget` with
|
||||
other Node.js APIs. Any code relying on the `process.on('error')` event should
|
||||
be aligned with the new behavior.
|
||||
|
||||
### Class: `Event`
|
||||
<!-- YAML
|
||||
|
||||
Reference in new issue
Block a user