process is a global; node:process and elide:process return the same object. It follows
Node’s process.
Named imports expose process properties and functions such as pid, cwd and resourceUsage.
EventEmitter methods such as on, once and emit belong to the default process export.
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;
elide run process.mjs prints:
number string true
true true
nextTick
promise
timeout
exit code 3
The process exits with status 3.
Differences from Node
process.resourceUsage()reports operating-system counters on Linux and macOS, including CPU time in microseconds and peak resident memory (maxRSS) in KiB. It throwsERR_SYSTEM_ERRORon Windows.process.sendandprocess.disconnectexist only in a child started withchild_process.fork().- Replacing
process.stdout.writealso interceptsconsole.log. process.nextTickcallbacks run before Promise andqueueMicrotaskcallbacks; see Timers.
For process.env loading and subprocess behavior, see Environment Variables.
Samples
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, 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.