diff --git a/doc/api/cli.md b/doc/api/cli.md index 2910c782d2ad8e..357f3c33a83884 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -2,7 +2,7 @@ -Node.js comes with a wide variety of CLI options. These options expose built-in +Node.js comes with a variety of CLI options. These options expose built-in debugging, multiple ways to execute scripts, and other helpful runtime options. To view this documentation as a manual page in your terminal, run `man node`. @@ -24,37 +24,58 @@ _For more info about `node debug`, please see the [debugger][] documentation._ ## Options ### `-v`, `--version` + Print node's version. ### `-h`, `--help` + Print node command line options. The output of this option is less detailed than this document. ### `-e`, `--eval "script"` + Evaluate the following argument as JavaScript. ### `-p`, `--print "script"` + Identical to `-e` but prints the result. ### `-c`, `--check` + Syntax check the script without executing. ### `-i`, `--interactive` + Opens the REPL even if stdin does not appear to be a terminal. ### `-r`, `--require module` + Preload the specified module at startup. @@ -63,48 +84,75 @@ rules. `module` may be either a path to a file, or a node module name. ### `--no-deprecation` + Silence deprecation warnings. ### `--trace-deprecation` + Print stack traces for deprecations. ### `--throw-deprecation` + Throw errors for deprecations. ### `--trace-sync-io` + Prints a stack trace whenever synchronous I/O is detected after the first turn of the event loop. ### `--zero-fill-buffers` + Automatically zero-fills all newly allocated [Buffer][] and [SlowBuffer][] instances. ### `--track-heap-objects` + Track heap object allocations for heap snapshots. ### `--prof-process` + Process v8 profiler output generated using the v8 option `--prof`. ### `--v8-options` + Print v8 command line options. ### `--tls-cipher-list=list` + Specify an alternative default TLS cipher list. (Requires Node.js to be built with crypto support. (Default)) @@ -123,6 +171,9 @@ Force FIPS-compliant crypto on startup. (Cannot be disabled from script code.) ### `--icu-data-dir=file` + Specify ICU data load path. (overrides `NODE_ICU_DATA`) @@ -130,11 +181,17 @@ Specify ICU data load path. (overrides `NODE_ICU_DATA`) ## Environment Variables ### `NODE_DEBUG=module[,…]` + `','`-separated list of core modules that should print debug information. ### `NODE_PATH=path[:…]` + `':'`-separated list of directories prefixed to the module search path. @@ -142,17 +199,26 @@ _Note: on Windows, this is a `';'`-separated list instead._ ### `NODE_DISABLE_COLORS=1` + When set to `1` colors will not be used in the REPL. ### `NODE_ICU_DATA=file` + Data path for ICU (Intl object) data. Will extend linked-in data when compiled with small-icu support. ### `NODE_REPL_HISTORY=file` + Path to the file used to store the persistent REPL history. The default path is `~/.node_repl_history`, which is overridden by this variable. Setting the value