doc: document REPL DEP0185 throws and uncaught-exception behavior - #64993
Merged
nodejs-github-bot merged 1 commit intoAug 13, 2026
Merged
doc: document REPL DEP0185 throws and uncaught-exception behavior#64993nodejs-github-bot merged 1 commit into
nodejs-github-bot merged 1 commit into
Conversation
Copy link
Copy Markdown
Contributor
Sorry, something went wrong.
edsadr
added a commit
to edsadr/node
that referenced
this pull request
Aug 3, 2026
Two doc-only improvements to `doc/api/repl.md`, both filling gaps left by recent semver-major REPL changes: 1. `repl.REPLServer` is an ES class; calling it without `new` is End-of-Life (DEP0185) and throws a native V8 `TypeError`. The "Class: REPLServer" section now notes this and links to the DEP0185 entry in `doc/api/deprecations.md`. No `Stability: 0` banner is added because the class itself is not deprecated — only the `new`-less invocation is — matching the parallel DEP0184/DEP0195 "classes without `new`" convention. 2. PR nodejs#64034 ("repl: use inspector over vm") removed the old "Global uncaught exceptions" subsection because the `domain`-based restrictions it documented no longer exist. A new top-level `### Error handling` section documents the current model (mirroring the `### Error handling` convention in async_hooks/http2/quic), anchored to the existing `Uncaught Error: REPL await` example. Refs: nodejs#59495 Refs: nodejs#54869 Refs: nodejs#54842 Refs: nodejs#64034 PR-URL: nodejs#64993 Signed-off-by: Adrian Estrada <edsadr@gmail.com>
edsadr
force-pushed
the
repl-doc-improvement
branch
from
2af31ef to
7f0999c
Compare
August 3, 2026 23:44
Two doc-only improvements to `doc/api/repl.md`, both filling gaps left by recent semver-major REPL changes: 1. `repl.REPLServer` is an ES class; calling it without `new` is End-of-Life (DEP0185) and throws a native V8 `TypeError`. The "Class: REPLServer" section now notes this and links to the DEP0185 entry in `doc/api/deprecations.md`. No `Stability: 0` banner is added because the class itself is not deprecated — only the `new`-less invocation is — matching the parallel DEP0184/DEP0195 "classes without `new`" convention. 2. PR nodejs#64034 ("repl: use inspector over vm") removed the old "Global uncaught exceptions" subsection because the `domain`-based restrictions it documented no longer exist. A new top-level `### Error handling` section documents the current model (mirroring the `### Error handling` convention in async_hooks/http2/quic), anchored to the existing `Uncaught Error: REPL await` example. Refs: nodejs#59495 Refs: nodejs#54869 Refs: nodejs#54842 Refs: nodejs#64034 PR-URL: nodejs#64993 Signed-off-by: Adrian Estrada <edsadr@gmail.com>
edsadr
force-pushed
the
repl-doc-improvement
branch
from
7f0999c to
e3a7241
Compare
August 3, 2026 23:49
ErickWendel
approved these changes
Aug 11, 2026
UlisesGascon
approved these changes
Aug 11, 2026
RafaelGSS
approved these changes
Aug 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Reviewers
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two doc-only improvements to doc/api/repl.md, both filling gaps left by recent semver-major REPL changes:
repl.REPLServer is an ES class. Calling it without new is End-of-Life (DEP0185) and throws a native V8 TypeError at runtime. The "Class: REPLServer" section showed examples that use new but did not tell users that the new-less form throws. A short prose note is added after the construction examples pointing to the DEP0185 entry in doc/api/deprecations.md.
PR repl: use inspector over vm #64034 ("repl: use inspector over vm") removed the old "Global uncaught exceptions" subsection because the domain-based restrictions it documented no longer exist. The removal was correct, but the current uncaught-exception model was only partially documented via the 'unhandled' description on the handleError option. A top-level Error handling section is added. The prose is anchored to the existing Uncaught Error: REPL await example in the preceding await keyword section and documents the current behavior: uncaught exceptions are printed by default, uncaughtException listeners work freely in standalone and nested REPLs, and the handleError option can forward exceptions to 'uncaughtException' by returning 'unhandled'.