diff --git a/doc/api/cli.md b/doc/api/cli.md index d7747d50beb451..702c2f308331ad 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -188,14 +188,21 @@ Enable FIPS-compliant crypto at startup. (Requires Node.js to be built with ### `--enable-source-maps` -> 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`