Skip to content

Commit

Permalink
errors: remove experimental from --enable-source-maps
Browse files Browse the repository at this point in the history
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>
  • Loading branch information
bcoe authored and MylesBorins committed Aug 31, 2021
1 parent da98c9f commit 9ee3f77
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions doc/api/cli.md
Expand Up @@ -188,14 +188,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
Expand Down

0 comments on commit 9ee3f77

Please sign in to comment.