Skip to content

Commit 9ee3f77

Browse files
bcoeMylesBorins
authored andcommittedAug 31, 2021
errors: remove experimental from --enable-source-maps
PR-URL: #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>
1 parent da98c9f commit 9ee3f77

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed
 

Diff for: ‎doc/api/cli.md

+11-4
Original file line numberDiff line numberDiff line change
@@ -188,14 +188,21 @@ Enable FIPS-compliant crypto at startup. (Requires Node.js to be built with
188188
### `--enable-source-maps`
189189
<!-- YAML
190190
added: v12.12.0
191+
changes:
192+
- version: REPLACEME
193+
pr-url: https://github.com/nodejs/node/pull/37362
194+
description: This API is no longer experimental.
191195
-->
192196

193-
> Stability: 1 - Experimental
197+
Enable [Source Map v3][Source Map] support for stack traces.
194198

195-
Enable experimental Source Map v3 support for stack traces.
199+
When using a transpiler, such as TypeScript, strack traces thrown by an
200+
application reference the transpiled code, not the original source position.
201+
`--enable-source-maps` enables caching of Source Maps and makes a best
202+
effort to report stack traces relative to the original source file.
196203

197-
Currently, overriding `Error.prepareStackTrace` is ignored when the
198-
`--enable-source-maps` flag is set.
204+
Overriding `Error.prepareStackTrace` prevents `--enable-source-maps` from
205+
modifiying the stack trace.
199206

200207
### `--experimental-abortcontroller`
201208
<!-- YAML

0 commit comments

Comments
 (0)
Please sign in to comment.