Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nodejs/node.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorbcoe <bencoe@google.com>2021-02-13 23:19:04 +0300
committerMichaƫl Zasso <targos@protonmail.com>2021-02-28 16:40:04 +0300
commit9ba5c0f9ba76a38c3a71ac587b259f230406fa80 (patch)
treed0048170fa4a0f95dbc667486dc8a4925a60dc9d /doc
parent4ad7a78448db59468049e91e9cdcb2545cccc9dc (diff)
errors: remove experimental from --enable-source-maps
PR-URL: https://github.com/nodejs/node/pull/37362 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Ian Sutherland <ian@iansutherland.ca> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Michael Dawson <midawson@redhat.com> Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Jiawen Geng <technicalcute@gmail.com> Reviewed-By: Beth Griggs <bgriggs@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/api/cli.md15
1 files changed, 11 insertions, 4 deletions
diff --git a/doc/api/cli.md b/doc/api/cli.md
index 70cb69cd54a..c9f51b65f94 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -192,14 +192,21 @@ Enable FIPS-compliant crypto at startup. (Requires Node.js to be built with
### `--enable-source-maps`
<!-- YAML
added: v12.12.0
+changes:
+ - version: REPLACEME
+ pr-url: https://github.com/nodejs/node/pull/37362
+ description: This API is no longer experimental.
-->
-> Stability: 1 - Experimental
+Enable [Source Map v3][Source Map] support for stack traces.
-Enable experimental Source Map v3 support for stack traces.
+When using a transpiler, such as TypeScript, strack traces thrown by an
+application reference the transpiled code, not the original source position.
+`--enable-source-maps` enables caching of Source Maps and makes a best
+effort to report stack traces relative to the original source file.
-Currently, overriding `Error.prepareStackTrace` is ignored when the
-`--enable-source-maps` flag is set.
+Overriding `Error.prepareStackTrace` prevents `--enable-source-maps` from
+modifiying the stack trace.
### `--experimental-abortcontroller`
<!-- YAML