process

process is a global; node:process and elide:process return the same object. It follows Node’s process.

Example

// process.mjs
process.on("exit", (code) => console.log("exit code", code));

console.log(typeof process.pid, typeof process.env.PATH, process.argv.length >= 2);
console.log(process.memoryUsage().rss > 0, process.hrtime.bigint() > 0n);

setTimeout(() => console.log("timeout"), 0);
Promise.resolve().then(() => console.log("promise"));
process.nextTick(() => console.log("nextTick"));
process.exitCode = 3;

utf-8 · js · Lines: 10

elide run process.mjs prints:

text

number string true
true true
nextTick
promise
timeout
exit code 3

utf-8 · text · Lines: 6

The process exits with status 3.

Differences from Node

process.resourceUsage is not available.
process.send and process.disconnect exist only in a child started with child_process.fork().
Replacing process.stdout.write also intercepts console.log.
process.nextTick callbacks run before Promise and queueMicrotask callbacks; see Timers.

For process.env loading and subprocess behavior, see Environment Variables.

Samples

Command-line arguments

Reference

Status: Partial · 77 of 87 suite tests pass (88.5%) · since 1.1.0

Exports

Export	Kind	Status	Notes
`process.arch`	property	Full	CPU architecture of the process (e.g. “x64”, “arm64”)
`process.argv`	property	Full	Command-line arguments passed to the process, starting with the node executable path
`process.argv0`	property	Full	The original value of argv[0] before any modification by Node.js
`process.env`	property	Full	Object containing the process environment variables
`process.execArgv`	property	Full	Node.js-specific flags passed to the node executable
`process.execPath`	property	Full	Absolute path of the node executable
`process.pid`	property	Full	Process ID
`process.ppid`	property	Full	Parent process ID
`process.platform`	property	Full	Operating system platform (e.g. “linux”, “darwin”, “win32”)
`process.title`	property	Full	Displayed process title (settable in most environments)
`process.version`	property	Full	Node.js version string (e.g. “v20.0.0”)
`process.versions`	property	Full	Object mapping dependency names to their version strings
`process.abort()`	function	Full	Terminates the process immediately with a core dump (SIGABRT)
`process.cwd()`	function	Full	Returns the current working directory of the process
`process.chdir()`	function	Full	Changes the current working directory of the process
`process.exit()`	function	Full	Terminates the process with the given exit code
`process.getuid()`	function	Full	Returns the numeric user ID of the process owner
`process.getgid()`	function	Full	Returns the numeric group ID of the process owner
`process.geteuid()`	function	Full	Returns the effective numeric user ID
`process.getegid()`	function	Full	Returns the effective numeric group ID
`process.hrtime()`	function	Full	Returns the current high-resolution time as [seconds, nanoseconds]
`process.umask()`	function	Full	Gets or sets the file creation mode mask
`process.cpuUsage()`	function	Full	Returns the CPU time used since an optional reference point
`process.memoryUsage()`	function	Full	Returns a snapshot of the current process memory usage
`process.uptime()`	function	Full	Returns the number of seconds the current process has been running
`process.nextTick()`	function	Full	Schedules a callback to run after I/O events but before timers in the current event loop tick
`process.stdin`	property	Full	Readable stream connected to stdin
`process.stdout`	property	Full	Writable stream connected to stdout
`process.stderr`	property	Full	Writable stream connected to stderr

Not implemented

addUncaughtExceptionCaptureCallback, debugPort, finalization, getBuiltinModule, report, resourceUsage, sourceMapsEnabled.

Tests: node-api node:process: 77 pass, 10 fail, 0 error, 6 skipped. Failing: test-process-dlopen-error-message-crash.js, test-process-env-allowed-flags-are-documented.js, test-process-env-allowed-flags.js, test-process-exec-argv.js, test-process-execve-permission-fail.js, test-process-exit-code-validation.js, test-process-load-env-file.js, test-process-remove-all-signal-listeners.js, and 2 more.