Usage: node [options] [ script.js ] [arguments]
node inspect [options] [ script.js | host:port ] [arguments]
Options:
- script read from stdin (default if no
file name is provided, interactive mode
if a tty)
-- indicate the end of node options
--abort-on-uncaught-exception
aborting instead of exiting causes a
core file to be generated for analysis
--allow-addons allow use of addons when any
permissions are set
--allow-child-process allow use of child process when any
permissions are set
--allow-ffi allow use of FFI when any permissions
are set
--allow-fs-read=... allow permissions to read the
filesystem
--allow-fs-vfs allow mounting a virtual file system
when any permissions are set
--allow-fs-write=... allow permissions to write in the
filesystem
--allow-inspector allow use of inspector when any
permissions are set
--allow-net allow use of network when any
permissions are set
--allow-openssl-store allow use of OpenSSL STORE loaders when
any permissions are set
--allow-wasi allow wasi when any permissions are set
--allow-worker allow worker threads when any
permissions are set
--bench launch benchmark runner on startup
--bench-isolation=... configures the type of benchmark
isolation used in the benchmark runner
--bench-name-pattern=... run benchmarks whose name matches this
regular expression
--bench-reporter=... report benchmark output using the given
reporter
--bench-reporter-destination=...
report the given benchmark reporter to
the given destination
--bench-samples=... specify the number of measured
benchmark samples
--bench-warmup=... specify the number of unreported
benchmark warmup samples
--build-sea=... Build a Node.js single executable
application
--build-snapshot Generate a snapshot blob when the
process exits.
--build-snapshot-config=... Generate a snapshot blob when the
process exits using aJSON configuration
in the specified path.
-c, --check syntax check script without executing
--completion-bash print source-able bash completion
script
-C, --conditions=... additional user conditions for
conditional exports and imports
--experimental-config-file, --experimental-default-config-file, --config-file=...
set config file path
--diagnostic-dir=... set dir for all output files (default:
current working directory)
--disable-proto=... disable Object.prototype.__proto__
--disable-sigusr1 Disable inspector thread to be
listening for SIGUSR1 signal
--disable-warning=... silence specific process warnings
--disable-wasm-trap-handler Disable trap-handler-based WebAssembly
bound checks. V8 will insert inline
bound checks when compiling WebAssembly
which may slow down performance.
--disallow-code-generation-from-strings
disallow eval and friends
--dns-result-order=... set default value of verbatim in
dns.lookup. Options are 'ipv4first'
(IPv4 addresses are placed before IPv6
addresses) 'ipv6first' (IPv6 addresses
are placed before IPv4 addresses)
'verbatim' (addresses are in the order
the DNS resolver returned)
--enable-etw-stack-walking provides heap data to ETW Windows
native tracing
--enable-fips enable FIPS crypto at startup
--enable-fips-indicator-events
publish FIPS indicator results to the
crypto.fips.indicator diagnostics
channel
--enable-source-maps Source Map V3 support for stack traces
--entry-url Treat the entrypoint as a URL
--env-file=... set environment variables from supplied
file
--env-file-if-exists=... set environment variables from supplied
file
-e, --eval=... evaluate script
--experimental-addon-modules
experimental import support for addons
(currently set)
--experimental-bench experimental node:bench module and
benchmark runner
--experimental-eventsource experimental EventSource API
--experimental-import-meta-resolve
experimental ES Module
import.meta.resolve() parentURL support
--experimental-import-text experimental support for importing
source as text with import attributes
--loader, --experimental-loader=...
use the specified module as a custom
loader
--experimental-package-map=...
use the specified file for package map
resolution
--experimental-print-required-tla
Print pending top-level await. If
--require-module is true, evaluate
asynchronous graphs loaded by
`require()` but do not run the
microtasks, in order to find and print
top-level await in the graph
--experimental-sea-config=...
Generate a blob that can be embedded
into the single executable application
--experimental-stream-iter experimental iterable streams API
(node:stream/iter)
--experimental-test-coverage
enable code coverage in the test runner
--experimental-test-module-mocks
enable module mocking in the test
runner
--experimental-test-tag-filter=...
run tests matching the given tag filter
expression
--experimental-vfs experimental node:vfs module
--experimental-vm-modules experimental ES Module support in vm
module
--experimental-web-worker experimental Web Worker API
--expose-gc expose gc extension
--force-context-aware disable loading non-context-aware
addons
--force-fips[=...] force FIPS crypto (optional mode:
provider or strict)
--force-node-api-uncaught-exceptions-policy
enforces 'uncaughtException' event on
Node API asynchronous callbacks
--frozen-intrinsics experimental frozen intrinsics support
--heapsnapshot-near-heap-limit=...
Generate heap snapshots whenever V8 is
approaching the heap limit. No more
than the specified number of heap
snapshots will be generated.
--heapsnapshot-signal=... Generate heap snapshot on specified
signal
-h, --help print node command line options
(currently set)
--icu-data-dir=... set ICU data load path to dir
(overrides NODE_ICU_DATA) (note:
linked-in ICU data is present)
--import=... ES module to preload (option can be
repeated)
--input-type=... set module type for string input
--insecure-http-parser use an insecure HTTP parser that
accepts invalid HTTP headers
-i, --interactive always enter the REPL even if stdin
does not appear to be a terminal
--interpreted-frames-native-stack
help system profilers to translate
JavaScript interpreted frames
--jitless disable runtime allocation of
executable memory
--localstorage-file=... file used to persist localStorage data
--max-http-header-size=... set the maximum size of HTTP headers
(default: 16384 (16KB))
--max-old-space-size-percentage=...
set V8's max old space size as a
percentage of available memory (e.g.,
'50%'). Takes precedence over
--max-old-space-size.
--network-family-autoselection-attempt-timeout=...
Sets the default value for the network
family autoselection attempt timeout.
--no-addons disable loading native addons
--no-async-context-frame Improve AsyncLocalStorage performance
with AsyncContextFrame
--no-deprecation silence deprecation warnings
--no-experimental-detect-module
when ambiguous modules fail to evaluate
because they contain ES module syntax,
try again to evaluate them as ES
modules
--no-experimental-ffi experimental node:ffi module
--no-experimental-global-navigator
expose experimental Navigator API on
the global scope
--no-experimental-repl-await
experimental await keyword support in
REPL
--no-experimental-require-module
Legacy alias for --require-module
--no-experimental-sqlite experimental node:sqlite module
--no-experimental-websocket experimental WebSocket API
--webstorage, --no-experimental-webstorage
experimental Web Storage API
--no-extra-info-on-fatal-exception
hide extra information on fatal
exception that causes exit
--no-force-async-hooks-checks
disable checks for async_hooks
--no-global-search-paths disable global module search paths
--enable-network-family-autoselection, --no-network-family-autoselection
Disable network address family
autodetection algorithm
--no-require-module Allow loading synchronous ES Modules in
require().
--experimental-strip-types, --no-strip-types
Type-stripping for TypeScript files.
--no-warnings silence all process warnings
--no-worker-snapshot start worker threads from the
bootstrapped context in the built-in
startup snapshot
--node-memory-debug Run with extra debug checks for memory
leaks in Node.js itself
--openssl-config=... load OpenSSL configuration from the
specified file (overrides OPENSSL_CONF)
--openssl-legacy-provider enable OpenSSL 3.0 legacy provider
--openssl-shared-config enable OpenSSL shared configuration
--pending-deprecation emit pending deprecation warnings
--permission enable the permission system
--permission-audit enable audit only for the permission
system
--preserve-symlinks preserve symbolic links when resolving
--preserve-symlinks-main preserve symbolic links when resolving
the main module
-p, --print [...] evaluate script and print result
--process-timeout=... print why the process is still running
and exit with code 124 if it has not
exited after the given duration (e.g.
30s)
--prof Generate V8 profiler output.
--prof-process process V8 profiler output generated
using --prof
--redirect-warnings=... write warnings to file instead of
stderr
--report-compact output compact single-line JSON
--report-directory, --report-dir=...
define custom report pathname.
(default: current working directory)
--report-exclude-env Exclude environment variables when
generating report (default: false)
--report-exclude-network exclude network interface diagnostics.
(default: false)
--report-filename=... define custom report file name.
(default:
YYYYMMDD.HHMMSS.PID.SEQUENCE#.txt)
--report-on-fatalerror generate diagnostic report on fatal
(internal) errors
--report-on-process-timeout generate diagnostic report when
--process-timeout expires
--report-on-signal generate diagnostic report upon
receiving signals
--report-signal=... causes diagnostic report to be produced
on provided signal, unsupported in
Windows. (default: SIGUSR2)
--report-uncaught-exception generate diagnostic report on uncaught
exceptions
-r, --require=... CommonJS module to preload (option can
be repeated)
--run=... Run a script specified in package.json
--secure-heap=... total size of the OpenSSL secure heap
--secure-heap-min=... minimum allocation size from the
OpenSSL secure heap
--snapshot-blob=... Path to the snapshot blob that's either
the result of snapshotbuilding, or the
blob that is used to restore the
application state
--test launch test runner on startup
--test-concurrency=... specify test runner concurrency
--test-coverage-branches=...
the branch coverage minimum threshold
--test-coverage-exclude=... exclude files from coverage report that
match this glob pattern
--test-coverage-functions=...
the function coverage minimum threshold
--test-coverage-include=... include files in coverage report that
match this glob pattern
--test-coverage-include-all include source files that were never
loaded in the coverage report
--test-coverage-lines=... the line coverage minimum threshold
--test-force-exit force test runner to exit upon
completion
--test-global-setup=... specifies the path to the global setup
file
--experimental-test-isolation, --test-isolation=...
configures the type of test isolation
used in the test runner
--test-name-pattern=... run tests whose name matches this
regular expression
--test-only run tests with 'only' option set
--test-random-seed=... seed used to randomize test execution
order
--test-randomize run tests in a random order
--test-reporter=... report test output using the given
reporter
--test-reporter-destination=...
report given reporter to the given
destination
--test-rerun-failures=... specifies the path to the rerun state
file
--test-shard=... run test at specific shard
--test-skip-pattern=... run tests whose name do not match this
regular expression
--test-timeout=... specify test runner timeout
--test-update-snapshots regenerate test snapshots
--throw-deprecation throw an exception on deprecations
--title=... the process title to use on startup
--tls-cipher-list=... use an alternative default TLS cipher
list
--tls-keylog=... log TLS decryption keys to named file
for traffic analysis
--tls-max-v1.2 set default TLS maximum to TLSv1.2
(default: TLSv1.3)
--tls-max-v1.3 set default TLS maximum to TLSv1.3
(default: TLSv1.3)
--tls-min-v1.0 set default TLS minimum to TLSv1.0
(default: TLSv1.2)
--tls-min-v1.1 set default TLS minimum to TLSv1.1
(default: TLSv1.2)
--tls-min-v1.2 set default TLS minimum to TLSv1.2
(default: TLSv1.2)
--tls-min-v1.3 set default TLS minimum to TLSv1.3
(default: TLSv1.2)
--trace-deprecation show stack traces on deprecations
--trace-env Print accesses to the environment
variables
--trace-env-js-stack Print accesses to the environment
variables and the JavaScript stack
trace
--trace-env-native-stack Print accesses to the environment
variables and the native stack trace
--trace-event-categories=...
comma separated list of trace event
categories to record
--trace-event-file-pattern=...
Template string specifying the filepath
for the trace-events data, it supports
${rotation} and ${pid}.
--trace-exit show stack trace when an environment
exits
--trace-promises show stack traces on promise
initialization and resolution
--trace-require-module=... Print access to require(esm). Options
are 'all' (print all usage) and
'no-node-modules' (excluding usage from
the node_modules folder)
--trace-sigint enable printing JavaScript stacktrace
on SIGINT
--trace-sync-io show stack trace when use of sync IO is
detected after the first tick
--trace-tls prints TLS packet trace information to
stderr
--trace-uncaught show stack traces for the `throw`
behind uncaught exceptions
--trace-warnings show stack traces on process warnings
--track-heap-objects track heap object allocations for heap
snapshots
--unhandled-rejections=... define unhandled rejections behavior.
Options are 'strict' (always raise an
error), 'throw' (raise an error unless
'unhandledRejection' hook is set),
'warn' (log a warning), 'none' (silence
warnings), 'warn-with-error-code' (log
a warning and set exit code 1 unless
'unhandledRejection' hook is set).
(default: throw)
--use-bundled-ca use bundled CA store
--use-env-proxy parse proxy settings from
HTTP_PROXY/HTTPS_PROXY/NO_PROXYenvironment
variables and apply the setting in
global HTTP/HTTPS clients
--use-largepages=... This option is no longer supported and
a no-op. It still accepts these values
for compatibility: 'off' (default),
'on' (report a warning to stderr), or
'silent' (same as 'off').
--use-openssl-ca use OpenSSL's default CA store
(default)
--use-system-ca use system's CA store
--v8-options print V8 command line options
--v8-pool-size=... set V8's thread pool size
-v, --version print Node.js version
--vfs-load=... mount a directory or archive as a
virtual file system and run the entry
point and module resolution against it
instead of the real file system (may be
given once; requires
--experimental-vfs)
--watch run in watch mode
--watch-kill-signal=... kill signal to send to the process on
watch mode restarts(default: SIGTERM)
--watch-path=... path to watch
--watch-preserve-output preserve outputs on watch mode restart
--zero-fill-buffers automatically zero-fill all newly
allocated Buffer instances
Environment variables:
FORCE_COLOR when set to 'true', 1, 2, 3, or an
empty string causes NO_COLOR and
NODE_DISABLE_COLORS to be ignored.
NO_COLOR Alias for NODE_DISABLE_COLORS
NODE_DEBUG ','-separated list of core modules that
should print debug information
NODE_DEBUG_NATIVE ','-separated list of C++ core debug
categories that should print debug
output
NODE_DISABLE_COLORS set to 1 to disable colors in the REPL
NODE_EXTRA_CA_CERTS path to additional CA certificates
file. Only read once during process
startup.
NODE_NO_WARNINGS set to 1 to silence process warnings
NODE_PATH ':'-separated list of directories
prefixed to the module search path
NODE_PENDING_DEPRECATION set to 1 to emit pending deprecation
warnings
NODE_PENDING_PIPE_INSTANCES set the number of pending pipe instance
handles on Windows
NODE_PRESERVE_SYMLINKS set to 1 to preserve symbolic links
when resolving and caching modules
NODE_REDIRECT_WARNINGS write warnings to path instead of
stderr
NODE_REPL_EXTERNAL_MODULE path to a Node.js module which will be
loaded in place of the built-in REPL
NODE_REPL_HISTORY path to the persistent REPL history
file
NODE_SKIP_PLATFORM_CHECK set to 1 to skip the check for a
supported platform during Node.js
startup
NODE_TLS_REJECT_UNAUTHORIZED
set to 0 to disable TLS certificate
validation
NODE_V8_COVERAGE directory to output v8 coverage JSON to
TZ specify the timezone configuration
UV_THREADPOOL_SIZE sets the number of threads used in
libuv's threadpool
Documentation can be found at https://nodejs.org/
Options (208)
| Option | Description | Source |
|---|---|---|
--abort-on-uncaught-exception | Aborting instead of exiting causes a core file to be generated for post-mortem analysis using a debugger (such as lldb, gdb, and mdb). | help + man |
--allow-addons | When using the Permission Model, the process will not be able to use native addons by default. | help + man |
--allow-child-process | When using the Permission Model, the process will not be able to spawn any child process by default. | help + man |
--allow-ffi | When using the Permission Model, the process will not be able to use FFI APIs by default. | help + man |
--allow-fs-read ... | This flag configures file system read permissions using the Permission Model. | help + man |
--allow-fs-vfs | When using the Permission Model, a virtual file system cannot be mounted by default: vfs.mount() throws ERR_INVALID_STATE unless the user explicitly passes the --allow-fs-vfs flag when starting… | help + man |
--allow-fs-write ... | This flag configures file system write permissions using the Permission Model. | help + man |
--allow-inspector | When using the Permission Model, the process will not be able to connect through inspector protocol. | help + man |
--allow-net | When using the Permission Model, the process will not be able to access network by default. | help + man |
--allow-openssl-store | When using the Permission Model, the process will not be able to use OpenSSL STORE loaders by default, for example to load a private key from a <URL> passed to crypto.createPrivateKey(). | help + man |
--allow-wasi | When using the Permission Model, the process will not be capable of creating any WASI instances by default. | help + man |
--allow-worker | When using the Permission Model, the process will not be able to create any worker threads by default. | help + man |
--bench | Starts the Node.js command-line benchmark runner. | help + man |
--bench-isolation ... | configures the type of benchmark isolation used in the benchmark runner | help + man |
--bench-name-pattern ... | Only runs benchmarks whose full hierarchical name matches the JavaScript regular expression pattern. | help + man |
--bench-reporter ... | report benchmark output using the given reporter | help + man |
--bench-reporter-destination ... | Specifies the destination for the corresponding benchmark reporter. | help + man |
--bench-samples ... | Overrides the maximum number of measured callback invocations for every selected benchmark. | help + man |
--bench-warmup ... | Overrides the number of unreported warmup callback invocations for every selected benchmark. | help + man |
--build-sea ... | Generates a single executable application from a JSON configuration file. | help + man |
--build-snapshot | Generates a snapshot blob when the process exits and writes it to disk, which can be loaded later with --snapshot-blob. | help + man |
-c, --check | Syntax check the script without executing. | help + man |
--completion-bash | Print source-able bash completion script for Node.js. | help + man |
-C, --conditions ... | additional user conditions for conditional exports and imports | help + man |
--experimental-config-file, --experimental-default-config-file, --config-file ... | If present, Node.js will look for a configuration file at the specified path. | help + man |
--diagnostic-dir ... | Set the directory to which all diagnostic output files are written. | help + man |
--disable-proto ... | Disable the Object.prototype.__proto__ property. | help + man |
--disable-sigusr1 | Disable the ability of starting a debugging session by sending a SIGUSR1 signal to the process. | help + man |
--disable-warning ... | Disable specific process warnings by code or type. | help + man |
--disallow-code-generation-from-strings | Make built-in language features like eval and new Function that generate code from strings throw an exception instead. | help + man |
--dns-result-order ... | Set the default value of order in dns.lookup() and dnsPromises.lookup(). | help + man |
--enable-etw-stack-walking | provides heap data to ETW Windows native tracing | help |
--enable-fips | enable FIPS crypto at startup | help + man |
--enable-fips-indicator-events | Publish OpenSSL FIPS indicator results to the 'crypto.fips.indicator' diagnostics channel. | help + man |
--enable-source-maps | Enable Source Map support for stack traces. | help + man |
--entry-url | When present, Node.js will interpret the entry point as a URL, rather than a path. | help + man |
--env-file ... | Loads environment variables from a file relative to the current directory, making them available to applications on process.env. | help + man |
--env-file-if-exists ... | Behavior is the same as --env-file, but an error is not thrown if the file does not exist. | help + man |
-e, --eval ... | Evaluate the following argument as JavaScript. | help + man |
--experimental-addon-modules | experimental import support for addons (currently set) | help + man |
--experimental-bench | Enable the experimental node:bench module and command-line benchmark runner. | help + man |
--experimental-eventsource | Enable exposition of EventSource Web API on the global scope. | help + man |
--experimental-import-meta-resolve | Enable experimental import.meta.resolve() parent URL support, which allows passing a second parentURL argument for contextual resolution. | help + man |
--experimental-import-text | Enable experimental support for importing modules with with { type: 'text' }. | help + man |
--loader, --experimental-loader ... | Specify the module containing exported asynchronous module customization hooks. | help + man |
--experimental-package-map ... | use the specified file for package map resolution | help + man |
--experimental-print-required-tla | If the ES module graph cannot be require()'d because it contains any top-level await, this flag allows Node.js to locate and print their locations. | help + man |
--experimental-sea-config ... | Use this flag to generate a blob that can be injected into the Node.js binary to produce a single executable application. | help + man |
--experimental-stream-iter | experimental iterable streams API (node:stream/iter) | help + man |
--experimental-test-coverage | When used in conjunction with the node:test module, a code coverage report is generated as part of the test runner output. | help + man |
--experimental-test-module-mocks | Enable module mocking in the test runner. | help + man |
--experimental-test-tag-filter ... | Run only tests that match the provided boolean tag-filter expression. | help + man |
--experimental-vfs | Enable the experimental node:vfs module. | help + man |
--experimental-vm-modules | Enable experimental ES Module support in the node:vm module. | help + man |
--experimental-web-worker | Enable experimental support for the Web Worker API. | help + man |
--expose-gc | expose gc extension | help |
--force-context-aware | Disable loading native addons that are not context-aware. | help + man |
--force-fips ... | Enable FIPS mode at startup and prevent it from being disabled from script code. | help + man |
--force-node-api-uncaught-exceptions-policy | enforces 'uncaughtException' event on Node API asynchronous callbacks | help + man |
--frozen-intrinsics | Enable experimental frozen intrinsics like Array and Object. | help + man |
--heapsnapshot-near-heap-limit ... | Writes a V8 heap snapshot to disk when the V8 heap usage is approaching the heap limit. | help + man |
--heapsnapshot-signal ... | Enables a signal handler that causes the Node.js process to write a heap dump when the specified signal is received. | help + man |
-h, --help | print node command line options (currently set) | help + man |
--icu-data-dir ... | set ICU data load path to dir (overrides NODE_ICU_DATA) (note: linked-in ICU data is present) | help + man |
--import ... | ES module to preload (option can be repeated) | help + man |
--input-type ... | This configures Node.js to interpret --eval or STDIN input as CommonJS or as an ES module. | help + man |
--insecure-http-parser | use an insecure HTTP parser that accepts invalid HTTP headers | help + man |
-i, --interactive | always enter the REPL even if stdin does not appear to be a terminal | help + man |
--interpreted-frames-native-stack | help system profilers to translate JavaScript interpreted frames | help |
--jitless | Disable runtime allocation of executable memory. | help + man |
--localstorage-file ... | The file used to store localStorage data. | help + man |
--max-http-header-size ... | set the maximum size of HTTP headers (default: 16384 (16KB)) | help + man |
--max-old-space-size-percentage ... | Sets the maximum memory size of V8's old memory section as a percentage of available system memory. | help + man |
--network-family-autoselection-attempt-timeout ... | Sets the default value for the network family autoselection attempt timeout. | help + man |
--no-addons | Disable the node-addons exports condition as well as disable loading native addons. | help + man |
--no-async-context-frame | Disables the use of AsyncLocalStorage backed by AsyncContextFrame and uses the prior implementation which relied on async_hooks. | help + man |
--no-deprecation | Silence deprecation warnings. | help + man |
--no-experimental-detect-module | when ambiguous modules fail to evaluate because they contain ES module syntax, try again to evaluate them as ES modules | help + man |
--no-experimental-ffi | Disable the experimental node:ffi module. | help + man |
--no-experimental-global-navigator | Disable exposition of Navigator API on the global scope. | help + man |
--no-experimental-repl-await | Use this flag to disable top-level await in REPL. | help + man |
--no-experimental-require-module | Legacy alias for --no-require-module. | help + man |
--no-experimental-sqlite | Disable the experimental node:sqlite module. | help + man |
--webstorage, --no-experimental-webstorage | experimental Web Storage API | help + man |
--no-extra-info-on-fatal-exception | Hide extra information on fatal exception that causes exit. | help + man |
--no-force-async-hooks-checks | Disables runtime checks for async_hooks. | help + man |
--no-global-search-paths | Do not search modules from global paths like $HOME/.node_modules and $NODE_PATH. | help + man |
--enable-network-family-autoselection, --no-network-family-autoselection | Disables the family autoselection algorithm unless connection options explicitly enables it. | help + man |
--no-require-module | Disable support for loading a synchronous ES module graph in require(). | help + man |
--experimental-strip-types, --no-strip-types | Disable type-stripping for TypeScript files. | help + man |
--no-warnings | Silence all process warnings (including deprecations). | help + man |
--no-worker-snapshot | Start worker threads by running the internal bootstrap from scratch instead of deserializing the bootstrapped context from the built-in startup snapshot. | help + man |
--node-memory-debug | Enable extra debug checks for memory leaks in Node.js internals. | help + man |
--openssl-config ... | load OpenSSL configuration from the specified file (overrides OPENSSL_CONF) | help + man |
--openssl-legacy-provider | Enable OpenSSL 3.0 legacy provider. | help + man |
--openssl-shared-config | Enable OpenSSL default configuration section, openssl_conf to be read from the OpenSSL configuration file. | help + man |
--pending-deprecation | Emit pending deprecation warnings. | help + man |
--permission | Enable the Permission Model for current process. | help + man |
--permission-audit | enable audit only for the permission system | help + man |
--preserve-symlinks | Instructs the module loader to preserve symbolic links when resolving and caching modules. | help + man |
--preserve-symlinks-main | Instructs the module loader to preserve symbolic links when resolving and caching the main module (require.main). | help + man |
-p, --print ... | Identical to -e but prints the result. | help + man |
--process-timeout ... | print why the process is still running and exit with code 124 if it has not exited after the given duration (e.g. 30s) | help + man |
--prof | Generate V8 profiler output. | help + man |
--prof-process | Process V8 profiler output generated using the V8 option --prof. | help + man |
--redirect-warnings ... | Write process warnings to the given file instead of printing to stderr. | help + man |
--report-compact | Write reports in a compact format, single-line JSON, more easily consumable by log processing systems than the default multi-line format designed for human consumption. | help + man |
--report-directory, --report-dir ... | Location at which the report will be generated. | help + man |
--report-exclude-env | When --report-exclude-env is passed the diagnostic report generated will not contain the environmentVariables data. | help + man |
--report-exclude-network | Exclude header.networkInterfaces from the diagnostic report. | help + man |
--report-filename ... | Name of the file to which the report will be written. | help + man |
--report-on-fatalerror | Enables the report to be triggered on fatal errors (internal errors within the Node.js runtime such as out of memory) that lead to termination of the application. | help + man |
--report-on-signal | Enables report to be generated upon receiving the specified (or predefined) signal to the running Node.js process. | help + man |
--report-signal ... | causes diagnostic report to be produced on provided signal, unsupported in Windows. | help + man |
-r, --require ... | CommonJS module to preload (option can be repeated) | help + man |
--run ... | This runs a specified command from a package.json's "scripts" object. | help + man |
--secure-heap ... | Initializes an OpenSSL secure heap of n bytes. | help + man |
--secure-heap-min ... | When using --secure-heap, the --secure-heap-min flag specifies the minimum allocation from the secure heap. | help + man |
--snapshot-blob ... | Path to the snapshot blob that's either the result of snapshotbuilding, or the blob that is used to restore the application state | help + man |
--test | Starts the Node.js command line test runner. | help + man |
--test-concurrency ... | The maximum number of test files that the test runner CLI will execute concurrently. | help + man |
--test-coverage-branches ... | Require a minimum percent of covered branches. | help + man |
--test-coverage-functions ... | Require a minimum percent of covered functions. | help + man |
--test-coverage-lines ... | Require a minimum percent of covered lines. | help + man |
--test-force-exit | Configures the test runner to exit the process once all known tests have finished executing even if the event loop would otherwise remain active. | help + man |
--test-global-setup ... | Specify a module that will be evaluated before all tests are executed and can be used to setup global state or fixtures for tests. | help + man |
--experimental-test-isolation, --test-isolation ... | Configures the type of test isolation used in the test runner. | help + man |
--test-name-pattern ... | A regular expression that configures the test runner to only execute tests whose name matches the provided pattern. | help + man |
--test-only | Configures the test runner to only execute top level tests that have the only option set. | help + man |
--test-random-seed ... | Set the seed used to randomize test execution order. | help + man |
--test-randomize | Randomize test execution order. | help + man |
--test-reporter ... | report test output using the given reporter | help + man |
--test-reporter-destination ... | The destination for the corresponding test reporter. | help + man |
--test-rerun-failures ... | A path to a file allowing the test runner to persist the state of the test suite between runs. | help + man |
--test-shard ... | Test suite shard to execute in a format of <index>/<total>, where | help + man |
--test-skip-pattern ... | A regular expression that configures the test runner to skip tests whose name matches the provided pattern. | help + man |
--test-timeout ... | A number of milliseconds the test execution will fail after. | help + man |
--test-update-snapshots | Regenerates the snapshot files used by the test runner for snapshot testing. | help + man |
--throw-deprecation | throw an exception on deprecations | help + man |
--title ... | the process title to use on startup | help + man |
--tls-cipher-list ... | Specify an alternative default TLS cipher list. | help + man |
--tls-keylog ... | log TLS decryption keys to named file for traffic analysis | help + man |
--tls-max-v1.2 | set default TLS maximum to TLSv1.2 (default: TLSv1.3) | help + man |
--tls-max-v1.3 | set default TLS maximum to TLSv1.3 (default: TLSv1.3) | help + man |
--tls-min-v1.0 | set default TLS minimum to TLSv1.0 (default: TLSv1.2) | help + man |
--tls-min-v1.1 | set default TLS minimum to TLSv1.1 (default: TLSv1.2) | help + man |
--tls-min-v1.2 | set default TLS minimum to TLSv1.2 (default: TLSv1.2) | help + man |
--tls-min-v1.3 | set default TLS minimum to TLSv1.3 (default: TLSv1.2) | help + man |
--trace-deprecation | Print stack traces for deprecations. | help + man |
--trace-env | Print information about any access to environment variables done in the current Node.js instance to stderr, including: | help + man |
--trace-env-js-stack | In addition to what --trace-env does, this prints the JavaScript stack trace of the access. | help + man |
--trace-env-native-stack | In addition to what --trace-env does, this prints the native stack trace of the access. | help + man |
--trace-event-categories ... | A comma separated list of categories that should be traced when trace event tracing is enabled using --trace-events-enabled. | help + man |
--trace-event-file-pattern ... | Template string specifying the filepath for the trace-events data, it supports ${rotation} and ${pid}. | help + man |
--trace-exit | Prints a stack trace whenever an environment is exited proactively, i.e. invoking process.exit(). | help + man |
--trace-promises | show stack traces on promise initialization and resolution | help |
--trace-require-module ... | Prints information about usage of Loading ECMAScript modules using require(). | help + man |
--trace-sigint | enable printing JavaScript stacktrace on SIGINT | help + man |
--trace-sync-io | Prints a stack trace whenever synchronous I/O is detected after the first turn of the event loop. | help + man |
--trace-tls | Prints TLS packet trace information to stderr. | help + man |
--trace-uncaught | show stack traces for the `throw` behind uncaught exceptions | help + man |
--trace-warnings | Print stack traces for process warnings (including deprecations). | help + man |
--track-heap-objects | Track heap object allocations for heap snapshots. | help + man |
--unhandled-rejections ... | Using this flag allows to change what should happen when an unhandled rejection occurs. | help + man |
--use-bundled-ca | Use bundled Mozilla CA store as supplied by current Node.js version or use OpenSSL's default CA store. | help + man |
--use-env-proxy | When enabled, Node.js parses the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables during startup, and routes requests through the specified proxy. | help + man |
--use-largepages ... | This option is no longer supported and a no-op. | help + man |
--use-openssl-ca | use OpenSSL's default CA store (default) | help |
--use-system-ca | Node.js uses the trusted CA certificates present in the system store along with the --use-bundled-ca option and the NODE_EXTRA_CA_CERTS environment variable. | help + man |
--v8-options | print V8 command line options | help |
--v8-pool-size ... | set V8's thread pool size | help |
-v, --version | print Node.js version | help |
--vfs-load ... | mount a directory or archive as a virtual file system and run the entry point and module resolution against it instead of the real file system (may be given once; | help |
--watch | run in watch mode | help |
--watch-kill-signal ... | kill signal to send to the process on watch mode restarts(default: SIGTERM) | help |
--watch-path ... | path to watch | help |
--watch-preserve-output | preserve outputs on watch mode restart | help |
--zero-fill-buffers | automatically zero-fill all newly allocated Buffer instances | help |
--build-snapshot-config | Specifies the path to a JSON configuration file which configures snapshot creation behavior. (in the manual page but not in --help) | man |
--cpu-prof | Starts the V8 CPU profiler on start up, and writes the CPU profile to disk before exit. (in the manual page but not in --help) | man |
--cpu-prof-dir | Specify the directory where the CPU profiles generated by --cpu-prof will be placed. (in the manual page but not in --help) | man |
--cpu-prof-interval | Specify the sampling interval in microseconds for the CPU profiles generated by --cpu-prof. (in the manual page but not in --help) | man |
--cpu-prof-name | Specify the file name of the CPU profile generated by --cpu-prof. (in the manual page but not in --help) | man |
--disable-wasm-trap-handler | Node.js enables V8's trap-handler-based WebAssembly bound checks on 64-bit platforms, which significantly improves WebAssembly performance by eliminating the need for inline bound checks. (in the manual page but not in --help) | man |
--experimental-dtls | Enable experimental support for the DTLS protocol. (in the manual page but not in --help) | man |
--experimental-inspector-network-resource | Enable experimental support for inspector network resources. (in the manual page but not in --help) | man |
--experimental-network-inspection | Enable experimental support for the network inspection with Chrome DevTools. (in the manual page but not in --help) | man |
--experimental-quic | Enable experimental support for the QUIC protocol. (in the manual page but not in --help) | man |
--experimental-shadow-realm | Use this flag to enable ShadowRealm support. (in the manual page but not in --help) | man |
--experimental-storage-inspection | Enable experimental support for storage inspection (in the manual page but not in --help) | man |
--experimental-wasi-unstable-preview1 | Enable experimental WebAssembly System Interface (WASI) support. (in the manual page but not in --help) | man |
--experimental-worker-inspection | Enable experimental support for the worker inspection with Chrome DevTools. (in the manual page but not in --help) | man |
--heap-prof | Starts the V8 heap profiler on start up, and writes the heap profile to disk before exit. (in the manual page but not in --help) | man |
--heap-prof-dir | Specify the directory where the heap profiles generated by --heap-prof will be placed. (in the manual page but not in --help) | man |
--heap-prof-interval | Specify the average sampling interval in bytes for the heap profiles generated by --heap-prof. (in the manual page but not in --help) | man |
--heap-prof-name | Specify the file name of the heap profile generated by --heap-prof. (in the manual page but not in --help) | man |
--inspect-brk host:]port | Activate inspector on host:port and break at start of user script. (in the manual page but not in --help) | man |
--inspect-port host:]port | Set the host:port to be used when the inspector is activated. (in the manual page but not in --help) | man |
--inspect-publish-uid stderr | Specify ways of the inspector web socket url exposure. (in the manual page but not in --help) | man |
--inspect-wait host:]port | Activate inspector on host:port and wait for debugger to be attached. (in the manual page but not in --help) | man |
--inspect host:]port | Activate inspector on host:port. (in the manual page but not in --help) | man |
--no-experimental-websocket | Disable exposition of <WebSocket> on the global scope. (in the manual page but not in --help) | man |
--report-on-process-timeout | Enables the report to be generated when --process-timeout expires, in addition to the summary printed to stderr. (in the manual page but not in --help) | man |
--report-uncaught-exception | Enables report to be generated when the process exits due to an uncaught exception. (in the manual page but not in --help) | man |
--test-coverage-exclude | Excludes specific files from code coverage using a glob pattern, which can match both absolute and relative file paths. (in the manual page but not in --help) | man |
--test-coverage-include | Includes specific files in code coverage using a glob pattern, which can match both absolute and relative file paths. (in the manual page but not in --help) | man |
--test-coverage-include-all | Includes source files that were never loaded by the test run in the coverage report, where they are reported as having zero coverage. (in the manual page but not in --help) | man |
--trace-events-enabled | Enables the collection of trace event tracing information. (in the manual page but not in --help) | man |