File Explorer

1.\"2.\" This manpage is written in mdoc(7).3.\"4.\" * Language reference:5.\"   https://man.openbsd.org/mdoc.76.\"7.\" * Linting changes:8.\"   mandoc -Wall -Tlint /path/to/this.file  # BSD9.\"   groff -w all -z /path/to/this.file      # GNU/Linux, macOS10.\"11.\"12.\" Before making changes, please note the following:13.\"14.\" * In Roff, each new sentence should begin on a new line. This gives15.\"   the Roff formatter better control over text-spacing, line-wrapping,16.\"   and paragraph justification.17.\"18.\" * Do not leave blank lines in the markup. If whitespace is desired19.\"   for readability, put a dot in the first column to indicate a null/empty20.\"   command. Comments and horizontal whitespace may optionally follow: each21.\"   of these lines are an example of a null command immediately followed by22.\"   a comment.23.\"24.\"======================================================================25.26.tr -\-^\(ha~\(ti`\(ga27.Dd 201828.Dt NODE 129.30.Sh NAME31.Nm node32.Nd server-side JavaScript runtime33.34.\"======================================================================35.Sh SYNOPSIS36.Nm node37.Op Ar options38.Op Ar v8-options39.Op Fl e Ar string | Ar script.js | Fl40.Op Fl -41.Op Ar arguments ...42.43.Nm node44.Cm inspect45.Op Fl e Ar string | Ar script.js | Fl | Ar <host>:<port>46.Ar ...47.48.Nm node49.Op Fl -v8-options50.51.\"======================================================================52.Sh DESCRIPTION53Node.js is a set of libraries for JavaScript which allows it to be used outside of the browser.54It is primarily focused on creating simple, easy-to-build network clients and servers.55.Pp56Execute57.Nm58without arguments to start a REPL.59.60.Sh OPTIONS61.Bl -tag -width 6n62.It Sy -63Alias for stdin, analogous to the use of - in other command-line utilities.64The executed script is read from stdin, and remaining arguments are passed to the script.65.66.It Fl -67Indicate the end of command-line options.68Pass the rest of the arguments to the script.69.Pp70If no script filename or eval/print script is supplied prior to this, then71the next argument will be used as a script filename.72.73.It Fl -abort-on-uncaught-exception74Aborting instead of exiting causes a core file to be generated for analysis.75.76.It Fl -allow-fs-read77Allow file system read access when using the permission model.78.79.It Fl -allow-fs-write80Allow file system write access when using the permission model.81.82.It Fl -allow-addons83Allow using native addons when using the permission model.84.85.It Fl -allow-child-process86Allow spawning process when using the permission model.87.88.It Fl -allow-inspector89Allow inspector access when using the permission model.90.91.It Fl -allow-wasi92Allow execution of WASI when using the permission model.93.94.It Fl -allow-worker95Allow creating worker threads when using the permission model.96.97.It Fl -completion-bash98Print source-able bash completion script for Node.js.99.100.It Fl C , Fl -conditions Ar string101Use custom conditional exports conditions.102.Ar string103.104.It Fl -cpu-prof105Start the V8 CPU profiler on start up, and write the CPU profile to disk106before exit. If107.Fl -cpu-prof-dir108is not specified, the profile will be written to the current working directory109with a generated file name.110.111.It Fl -cpu-prof-dir112The directory where the CPU profiles generated by113.Fl -cpu-prof114will be placed.115The default value is controlled by the116.Fl -diagnostic-dir .117command-line option.118.119.It Fl -cpu-prof-interval120The sampling interval in microseconds for the CPU profiles generated by121.Fl -cpu-prof .122The default is123.Sy 1000 .124.125.It Fl -cpu-prof-name126File name of the V8 CPU profile generated with127.Fl -cpu-prof .128.129.It Fl -diagnostic-dir130Set the directory for all diagnostic output files.131Default is current working directory.132Set the directory to which all diagnostic output files will be written to.133Defaults to current working directory.134.135Affects the default output directory of:136.Fl -cpu-prof-dir .137.Fl -heap-prof-dir .138.Fl -redirect-warnings .139.140.It Fl -disable-proto Ns = Ns Ar mode141Disable the `Object.prototype.__proto__` property. If142.Ar mode143is `delete`, the property will be removed entirely. If144.Ar mode145is `throw`, accesses to the property will throw an exception with the code146`ERR_PROTO_ACCESS`.147.148.It Fl -disable-wasm-trap-handler Ns = Ns Ar mode149Disable trap-handler-based WebAssembly bound checks and fall back to150inline bound checks so that WebAssembly can be run with limited virtual151memory.152.153.It Fl -disallow-code-generation-from-strings154Make built-in language features like `eval` and `new Function` that generate155code from strings throw an exception instead. This does not affect the Node.js156`vm` module.157.158.It Fl -enable-fips159Enable FIPS-compliant crypto at startup.160Requires Node.js to be built with161.Sy ./configure --openssl-fips .162.163.It Fl -enable-source-maps164Enable Source Map V3 support for stack traces.165.166.It Fl -entry-url167Interpret the entry point as a URL.168.169.It Fl -experimental-addon-modules170Enable experimental addon module support.171.172.It Fl -experimental-config-file173Specifies the configuration file to load.174.175.It Fl -experimental-default-config-file176Enable support for automatically loading node.config.json.177.178.It Fl -experimental-import-meta-resolve179Enable experimental ES modules support for import.meta.resolve().180.181.It Fl -experimental-loader Ns = Ns Ar module182Specify the183.Ar module184to use as a custom module loader.185.186.It Fl -permission187Enable the permission model.188.189.It Fl -experimental-shadow-realm190Use this flag to enable ShadowRealm support.191.192.It Fl -experimental-test-coverage193Enable code coverage in the test runner.194.195.It Fl -experimental-test-module-mocks196Enable module mocking in the test runner.197.198.It Fl -experimental-transform-types199Enable transformation of TypeScript-only syntax into JavaScript code.200.201.It Fl -experimental-eventsource202Enable experimental support for the EventSource Web API.203.204.It Fl -no-experimental-websocket205Disable experimental support for the WebSocket API.206.207.It Fl -experimental-webstorage208Enable experimental support for the Web Storage API.209.210.It Fl -no-experimental-repl-await211Disable top-level await keyword support in REPL.212.213.It Fl -no-experimental-sqlite214Disable the experimental node:sqlite module.215.216.It Fl -no-strip-types217Disable type-stripping for TypeScript files.218.219.It Fl -experimental-vm-modules220Enable experimental ES module support in VM module.221.222.It Fl -experimental-wasi-unstable-preview1223Enable experimental WebAssembly System Interface support. This224flag is no longer required as WASI is enabled by default.225.226.It Fl -experimental-quic227Enable the experimental QUIC support.228.229.It Fl -experimental-inspector-network-resource230Enable experimental support for inspector network resources.231.232.It Fl -force-context-aware233Disable loading native addons that are not context-aware.234.235.It Fl -force-fips236Force FIPS-compliant crypto on startup237(Cannot be disabled from script code).238Same requirements as239.Fl -enable-fips .240.241.It Fl -frozen-intrinsics242Enable experimental frozen intrinsics support.243.244.It Fl -heapsnapshot-near-heap-limit Ns = Ns Ar max_count245Generate heap snapshot when the V8 heap usage is approaching the heap limit.246No more than the specified number of snapshots will be generated.247.248.It Fl -heapsnapshot-signal Ns = Ns Ar signal249Generate heap snapshot on specified signal.250.251.It Fl -heap-prof252Start the V8 heap profiler on start up, and write the heap profile to disk253before exit. If254.Fl -heap-prof-dir255is not specified, the profile will be written to the current working directory256with a generated file name.257.258.It Fl -heap-prof-dir259The directory where the heap profiles generated by260.Fl -heap-prof261will be placed.262The default value is controlled by the263.Fl -diagnostic-dir .264command-line option.265.266.It Fl -heap-prof-interval267The average sampling interval in bytes for the heap profiles generated by268.Fl -heap-prof .269The default is270.Sy 512 * 1024 .271.272.It Fl -heap-prof-name273File name of the V8 heap profile generated with274.Fl -heap-prof .275.276.It Fl -icu-data-dir Ns = Ns Ar file277Specify ICU data load path.278Overrides279.Ev NODE_ICU_DATA .280.281.It Fl -input-type Ns = Ns Ar type282Set the module resolution type for input via --eval, --print or STDIN.283.284.It Fl -inspect-brk Ns = Ns Ar [host:]port285Activate inspector on286.Ar host:port287and break at start of user script.288.289.It Fl -inspect-port Ns = Ns Ar [host:]port290Set the291.Ar host:port292to be used when the inspector is activated.293.294.It Fl -inspect-publish-uid=stderr,http295Specify how the inspector WebSocket URL is exposed.296Valid values are297.Sy stderr298and299.Sy http .300Default is301.Sy stderr,http .302.303.It Fl -inspect-wait Ns = Ns Ar [host:]port304Activate inspector on305.Ar host:port306and wait for debugger to be attached.307.308.It Fl -inspect Ns = Ns Ar [host:]port309Activate inspector on310.Ar host:port .311Default is312.Sy 127.0.0.1:9229 .313.Pp314V8 Inspector integration allows attaching Chrome DevTools and IDEs to Node.js instances for debugging and profiling.315It uses the Chrome DevTools Protocol.316.317.It Fl -insecure-http-parser318Use an insecure HTTP parser that accepts invalid HTTP headers. This may allow319interoperability with non-conformant HTTP implementations. It may also allow320request smuggling and other HTTP attacks that rely on invalid headers being321accepted. Avoid using this option.322.323.It Fl -jitless324Disable runtime allocation of executable memory. This may be required on325some platforms for security reasons. It can also reduce attack surface on326other platforms, but the performance impact may be severe.327.328.Pp329This flag is inherited from V8 and is subject to change upstream. It may330disappear in a non-semver-major release.331.332.It Fl -localstorage-file Ns = Ns Ar file333The file used to store localStorage data.334.335.It Fl -max-http-header-size Ns = Ns Ar size336Specify the maximum size of HTTP headers in bytes. Defaults to 16 KiB.337.338.It Fl -max-old-space-size-percentage Ns = Ns Ar percentage339Sets the maximum memory size of V8's old memory section as a percentage of available system memory.340This flag takes precedence over341.Fl -max-old-space-size342when both are specified.343The344.Ar percentage345parameter must be a number greater than 0 and up to 100, representing the percentage346of available system memory to allocate to the V8 heap.347.Pp348Note: This flag utilizes349.Fl -max-old-space-size ,350which may be unreliable on 32-bit platforms due to integer overflow issues.351.352.It Fl -napi-modules353This option is a no-op.354It is kept for compatibility.355.356.It Fl -no-deprecation357Silence deprecation warnings.358.359.It Fl -no-extra-info-on-fatal-exception360Hide extra information on fatal exception that causes exit.361.362.It Fl -no-force-async-hooks-checks363Disable runtime checks for `async_hooks`.364These will still be enabled dynamically when `async_hooks` is enabled.365.366.It Fl -no-addons367Disable the `node-addons` exports condition as well as disable loading native368addons. When `--no-addons` is specified, calling `process.dlopen` or requiring369a native C++ addon will fail and throw an exception.370.371.It Fl -no-global-search-paths372Do not search modules from global paths.373.374.It Fl -no-warnings375Silence all process warnings (including deprecations).376.377.It Fl -node-memory-debug378Enable extra debug checks for memory leaks in Node.js internals. This is379usually only useful for developers debugging Node.js itself.380.381.It Fl -openssl-config Ns = Ns Ar file382Load an OpenSSL configuration file on startup.383Among other uses, this can be used to enable FIPS-compliant crypto if Node.js is built with384.Sy ./configure --openssl-fips .385.386.It Fl -pending-deprecation387Emit pending deprecation warnings.388.389.It Fl -preserve-symlinks390Instructs the module loader to preserve symbolic links when resolving and caching modules other than the main module.391.392.It Fl -preserve-symlinks-main393Instructs the module loader to preserve symbolic links when resolving and caching the main module.394.395.It Fl -prof396Generate V8 profiler output.397.398.It Fl -prof-process399Process V8 profiler output generated using the V8 option400.Fl -prof .401.402.It Fl -redirect-warnings Ns = Ns Ar file403Write process warnings to the given404.Ar file405instead of printing to stderr.406.407.It Fl -report-compact408Write409.Sy diagnostic reports410in a compact format, single-line JSON.411.412.It Fl -report-dir Fl -report-directory413Location at which the414.Sy diagnostic report415will be generated.416The `file` name may be an absolute path. If it is not, the default directory it will417be written to is controlled by the418.Fl -diagnostic-dir .419command-line option.420.421.It Fl -report-filename422Name of the file to which the423.Sy diagnostic report424will be written.425.426.It Fl -report-on-fatalerror427Enables the428.Sy diagnostic report429to be triggered on fatal errors (internal errors within the Node.js runtime such430as out of memory) that leads to termination of the application. Useful to431inspect various diagnostic data elements such as heap, stack, event loop state,432resource consumption etc. to reason about the fatal error.433.434.It Fl -report-on-signal435Enables436.Sy diagnostic report437to be generated upon receiving the specified (or predefined) signal to the438running Node.js process. Default signal is SIGUSR2.439.440.It Fl -report-signal441Sets or resets the signal for442.Sy diagnostic report443generation (not supported on Windows). Default signal is SIGUSR2.444.445.It Fl -report-uncaught-exception446Enables447.Sy diagnostic report448to be generated on un-caught exceptions. Useful when inspecting JavaScript449stack in conjunction with native stack and other runtime environment data.450.451.It Fl -secure-heap Ns = Ns Ar n452Specify the size of the OpenSSL secure heap. Any value less than 2 disables453the secure heap. The default is 0. The value must be a power of two.454.455.It Fl -secure-heap-min Ns = Ns Ar n456Specify the minimum allocation from the OpenSSL secure heap. The default is 2. The value must be a power of two.457.458.It Fl -test459Starts the Node.js command line test runner.460.461.It Fl -test-concurrency462The maximum number of test files that the test runner CLI will execute463concurrently.464.465.It Fl -test-coverage-branches Ns = Ns Ar threshold466Require a minimum threshold for branch coverage (0 - 100).467.468.It Fl -test-coverage-exclude469A glob pattern that excludes matching files from the coverage report470.471.It Fl -test-coverage-functions Ns = Ns Ar threshold472Require a minimum threshold for function coverage (0 - 100).473.474.It Fl -test-coverage-include475A glob pattern that only includes matching files in the coverage report476.477.It Fl -test-coverage-lines Ns = Ns Ar threshold478Require a minimum threshold for line coverage (0 - 100).479.480.It Fl -test-force-exit481Configures the test runner to exit the process once all known tests have482finished executing even if the event loop would otherwise remain active.483.484.It Fl -test-global-setup485Specifies a module containing global setup and teardown functions for the test runner.486.487.It Fl -test-isolation Ns = Ns Ar mode488Configures the type of test isolation used in the test runner.489.490.It Fl -test-name-pattern491A regular expression that configures the test runner to only execute tests492whose name matches the provided pattern.493.494.It Fl -test-reporter495A test reporter to use when running tests.496.497.It Fl -test-reporter-destination498The destination for the corresponding test reporter.499.500.It Fl -test-rerun-failures501Configures the tests runner to persist the state of tests to allow502rerunning only failed tests.503.504.It Fl -test-only505Configures the test runner to only execute top level tests that have the `only`506option set.507.508.It Fl -test-shard509Test suite shard to execute in a format of <index>/<total>.510.511.It Fl -test-skip-pattern512A regular expression that configures the test runner to skip tests513whose name matches the provided pattern.514.515.It Fl -test-timeout516A number of milliseconds the test execution will fail after.517.518.It Fl -test-update-snapshots519Regenerates the snapshot file used by the test runner for snapshot testing.520.521.It Fl -throw-deprecation522Throw errors for deprecations.523.524.It Fl -title Ns = Ns Ar title525Specify process.title on startup.526.527.It Fl -tls-cipher-list Ns = Ns Ar list528Specify an alternative default TLS cipher list.529Requires Node.js to be built with crypto support. (Default)530.531.It Fl -tls-keylog Ns = Ns Ar file532Log TLS key material to a file. The key material is in NSS SSLKEYLOGFILE533format and can be used by software (such as Wireshark) to decrypt the TLS534traffic.535.536.It Fl -tls-max-v1.2537Set default  maxVersion to 'TLSv1.2'. Use to disable support for TLSv1.3.538.539.It Fl -tls-max-v1.3540Set default  maxVersion to 'TLSv1.3'. Use to enable support for TLSv1.3.541.542.It Fl -tls-min-v1.0543Set default minVersion to 'TLSv1'. Use for compatibility with old TLS clients544or servers.545.546.It Fl -tls-min-v1.1547Set default minVersion to 'TLSv1.1'. Use for compatibility with old TLS clients548or servers.549.550.It Fl -tls-min-v1.2551Set default minVersion to 'TLSv1.2'. This is the default for 12.x and later,552but the option is supported for compatibility with older Node.js versions.553.554.It Fl -tls-min-v1.3555Set default minVersion to 'TLSv1.3'. Use to disable support for TLSv1.2 in556favour of TLSv1.3, which is more secure.557.558.It Fl -trace-deprecation559Print stack traces for deprecations.560.561.It Fl -trace-event-categories Ar categories562A comma-separated list of categories that should be traced when trace event tracing is enabled using563.Fl -trace-events-enabled .564.565.It Fl -trace-event-file-pattern Ar pattern566Template string specifying the filepath for the trace event data, it567supports568.Sy ${rotation}569and570.Sy ${pid} .571.572.It Fl -trace-events-enabled573Enable the collection of trace event tracing information.574.575.It Fl -trace-exit576Prints a stack trace whenever an environment is exited proactively,577i.e. invoking `process.exit()`.578.It Fl -trace-sigint579Prints a stack trace on SIGINT.580.581.It Fl -trace-sync-io582Print a stack trace whenever synchronous I/O is detected after the first turn of the event loop.583.584.It Fl -trace-tls585Prints TLS packet trace information to stderr.586.587.It Fl -trace-uncaught588Print stack traces for uncaught exceptions; usually, the stack trace associated589with the creation of an590.Sy Error591is printed, whereas this makes Node.js also592print the stack trace associated with throwing the value (which does not need593to be an594.Sy Error595instance).596.Pp597Enabling this option may affect garbage collection behavior negatively.598.599.It Fl -trace-warnings600Print stack traces for process warnings (including deprecations).601.602.It Fl -track-heap-objects603Track heap object allocations for heap snapshots.604.605.It Fl -unhandled-rejections=mode606Define the behavior for unhandled rejections. Can be one of `strict` (raise an error), `warn` (enforce warnings) or `none` (silence warnings).607.608.It Fl -use-bundled-ca , Fl -use-openssl-ca609Use bundled Mozilla CA store as supplied by current Node.js version or use OpenSSL's default CA store.610The default store is selectable at build-time.611.Pp612The bundled CA store, as supplied by Node.js, is a snapshot of Mozilla CA store that is fixed at release time.613It is identical on all supported platforms.614.Pp615Using OpenSSL store allows for external modifications of the store.616For most Linux and BSD distributions, this store is maintained by the distribution maintainers and system administrators.617OpenSSL CA store location is dependent on configuration of the OpenSSL library but this can be altered at runtime using environment variables.618.Pp619See620.Ev SSL_CERT_DIR621and622.Ev SSL_CERT_FILE .623.624.It Fl -use-env-proxy625Parse proxy settings from HTTP_PROXY/HTTPS_PROXY/NO_PROXY environment variables and apply the setting in global HTTP/HTTPS clients.626.627.It Fl -use-system-ca628Use the trusted CA certificates present in the system store, in addition to the certificates in the629bundled Mozilla CA store and certificates from `NODE_EXTRA_CA_CERTS`. On Windows and macOS, it uses system APIs to630integrate additional trusted certificates. On other platforms it is similar to `--use-openssl-ca` with the difference631being that it caches the certificates on first load, and the system certificates are added in a complementary manner632without replacing certificates from other sources. This flag supersedes `--use-openssl-ca`.633.634.It Fl -use-largepages Ns = Ns Ar mode635Re-map the Node.js static code to large memory pages at startup. If supported on636the target system, this will cause the Node.js static code to be moved onto 2637MiB pages instead of 4 KiB pages.638.Pp639.Ar mode640must have one of the following values:641`off` (the default value, meaning do not map), `on` (map and ignore failure,642reporting it to stderr), or `silent` (map and silently ignore failure).643.644.It Fl -v8-options645Print V8 command-line options.646.647.It Fl -v8-pool-size Ns = Ns Ar num648Set V8's thread pool size which will be used to allocate background jobs.649If set to 0 then V8 will choose an appropriate size of the thread pool based on the number of online processors.650If the value provided is larger than V8's maximum, then the largest value will be chosen.651.652.It Fl -watch653Starts Node.js in watch mode. When in watch mode, changes in the watched files cause the Node.js process to restart.654 655By default, watch mode will watch the entry point and any required or imported module. Use --watch-path to specify what paths to watch.656.657.It Fl -watch-path658Starts Node.js in watch mode and specifies what paths to watch. When in watch mode, changes in the watched paths cause the Node.js process to restart.659 660This will turn off watching of required or imported modules, even when used in combination with --watch.661.662.It Fl -watch-kill-signal663Customizes the signal sent to the process on watch mode restarts.664.665.It Fl -zero-fill-buffers666Automatically zero-fills all newly allocated Buffer and SlowBuffer instances.667.668.It Fl c , Fl -check669Check the script's syntax without executing it.670Exits with an error code if script is invalid.671.672.It Fl e , Fl -eval Ar string673Evaluate674.Ar string675as JavaScript.676.677.It Fl h , Fl -help678Print command-line options.679The output of this option is less detailed than this document.680.681.It Fl i , Fl -interactive682Open the REPL even if stdin does not appear to be a terminal.683.684.It Fl p , Fl -print Ar string685Identical to686.Fl e ,687but prints the result.688.689.It Fl r , Fl -require Ar module690Preload the specified691.Ar module692at startup.693Follows `require()`'s module resolution rules.694.Ar module695may be either a path to a file, or a Node.js module name.696.697.It Fl v , Fl -version698Print node's version.699.El700.701.\" =====================================================================702.Sh ENVIRONMENT703.Bl -tag -width 6n704.It Ev FORCE_COLOR705Used to enable ANSI colorized output. The value may be one of:706.Ar 1707,708.Ar true709, or710.Ar an empty string711to712indicate 16-color support,713.Ar 2714to indicate 256-color support, or715.Ar 3716to indicate 16 million-color support. When used and set to a supported717value, both the NO_COLOR and NODE_DISABLE_COLORS environment variables718are ignored. Any other value will result in colorized output being719disabled.720.721.It Ev NO_COLOR722Alias for NODE_DISABLE_COLORS723.724.It Ev NODE_COMPILE_CACHE Ar dir725Enable the726.Sy module compile cache727for the Node.js instance.728.729.It Ev NODE_COMPILE_CACHE_PORTABLE730When set to '1' or 'true', the731.Sy module compile cache732will be hit as long as the location of the modules relative to the cache directory remain733consistent. This can be used in conjunction with .Ev NODE_COMPILE_CACHE734to enable portable on-disk caching.735.736.It Ev NODE_DEBUG Ar modules...737Comma-separated list of core modules that should print debug information.738.739.It Ev NODE_DEBUG_NATIVE Ar modules...740Comma-separated list of C++ core modules that should print debug information.741.742.It Ev NODE_DISABLE_COMPILE_CACHE743Disable the744.Sy module compile cache745for the Node.js instance.746.747.It Ev NODE_DISABLE_COLORS748When set to749.Ar 1 ,750colors will not be used in the REPL.751.752.It Ev NODE_EXTRA_CA_CERTS Ar file753When set, the well-known754.Dq root755CAs (like VeriSign) will be extended with the extra certificates in756.Ar file .757The file should consist of one or more trusted certificates in PEM format.758.Pp759If760.Ar file761is missing or misformatted, a message will be emitted once using762.Sy process.emitWarning() ,763but any errors are otherwise ignored.764.Pp765This environment variable is ignored when `node` runs as setuid root or766has Linux file capabilities set.767.Pp768The769.Ar NODE_EXTRA_CA_CERTS770environment variable is only read when the Node.js process is first launched.771Changing the value at runtime using772.Ar process.env.NODE_EXTRA_CA_CERTS773has no effect on the current process.774.775.It Ev NODE_ICU_DATA Ar file776Data path for ICU (Intl object) data.777Will extend linked-in data when compiled with small-icu support.778.779.It Ev NODE_NO_WARNINGS780When set to781.Ar 1 ,782process warnings are silenced.783.784.It Ev NODE_OPTIONS Ar options...785A space-separated list of command-line786.Ar options ,787which are interpreted as if they had been specified on the command line before the actual command (so they can be overridden).788Node.js will exit with an error if an option that is not allowed in the environment is used, such as789.Fl -print790or a script file.791.792.It Ev NODE_PATH Ar directories...793A colon-separated list of794.Ar directories795prefixed to the module search path.796.797.It Ev NODE_PENDING_DEPRECATION798When set to799.Ar 1 ,800emit pending deprecation warnings.801.802.It Ev NODE_PENDING_PIPE_INSTANCES803Set the number of pending pipe instance handles when the pipe server is waiting for connections. This setting applies to Windows only.804.805.It Ev NODE_PRESERVE_SYMLINKS806When set to807.Ar 1 ,808the module loader preserves symbolic links when resolving and caching modules.809.810.It Ev NODE_REDIRECT_WARNINGS Ar file811Write process warnings to the given812.Ar file813instead of printing to stderr.814Equivalent to passing815.Fl -redirect-warnings Ar file816on the command line.817.818.It Ev NODE_REPL_HISTORY Ar file819Path to the820.Ar file821used to store persistent REPL history.822The default path is823.Sy ~/.node_repl_history ,824which is overridden by this variable.825Setting the value to an empty string ("" or " ") will disable persistent REPL history.826.827.It Ev NODE_REPL_EXTERNAL_MODULE Ar file828Path to a Node.js module which will be loaded in place of the built-in REPL.829Overriding this value to an empty string (`''`) will use the built-in REPL.830.831.It Ev NODE_SKIP_PLATFORM_CHECK832When set to833.Ar 1 ,834the check for a supported platform is skipped during Node.js startup.835Node.js might not execute correctly.836Any issues encountered on unsupported platforms will not be fixed.837.838.It Ev NODE_TEST_CONTEXT839When set to840.Ar 'child'841, test reporter options will be overridden and test output will be sent to stdout in the TAP format.842If any other value is provided, Node.js makes no guarantees about the reporter format used or its stability.843.844.It Ev NODE_TLS_REJECT_UNAUTHORIZED845When set to846.Ar 0 ,847TLS certificate validation is disabled.848.849.It Ev NODE_USE_ENV_PROXY850When enabled, Node.js parses the851.Ar HTTP_PROXY852,853.Ar HTTPS_PROXY854and855.Ar NO_PROXY856environment variables during startup, and tunnels requests over the specified proxy.857.Pp858This currently only affects requests sent over859.Ar fetch() .860Support for other built-in http and https methods is under way.861.862.It Ev NODE_USE_SYSTEM_CA863Similar to864.Fl -use-system-ca .865Use the trusted CA certificates present in the system store, in addition to the certificates in the866bundled Mozilla CA store and certificates from `NODE_EXTRA_CA_CERTS`.867.868.It Ev NODE_V8_COVERAGE Ar dir869When set, Node.js writes JavaScript code coverage information to870.Ar dir .871.872.It Ev OPENSSL_CONF Ar file873Load an OpenSSL configuration file on startup.874Among other uses, this can be used to enable FIPS-compliant crypto if Node.js is built with875.Sy ./configure --openssl-fips .876.Pp877If the878.Fl -openssl-config879command-line option is used, this environment variable is ignored.880.881.It Ev SSL_CERT_DIR Ar dir882If883.Fl -use-openssl-ca884is enabled, this overrides and sets OpenSSL's directory containing trusted certificates.885.886.It Ev SSL_CERT_FILE Ar file887If888.Fl -use-openssl-ca889is enabled, this overrides and sets OpenSSL's file containing trusted certificates.890.891.It Ev TZ892Specify the timezone configuration.893.894.It Ev UV_THREADPOOL_SIZE Ar size895Sets the number of threads used in libuv's threadpool to896.Ar size .897.898.El899.\"=====================================================================900.Sh BUGS901Bugs are tracked in GitHub Issues:902.Sy https://github.com/nodejs/node/issues903.904.\"======================================================================905.Sh COPYRIGHT906Copyright Node.js contributors.907Node.js is available under the MIT license.908.909.Pp910Node.js also includes external libraries that are available under a variety of licenses.911See912.Sy https://github.com/nodejs/node/blob/HEAD/LICENSE913for the full license text.914.915.\"======================================================================916.Sh SEE ALSO917Website:918.Sy https://nodejs.org/919.920.Pp921Documentation:922.Sy https://nodejs.org/api/923.924.Pp925GitHub repository and issue tracker:926.Sy https://github.com/nodejs/node927