process

The process module is specifically designed for use in JSH applications.

env

The JSH runtime environment object.

Usage example

1
2

const process = require('process');
console.println(process.env.get('HOME'));

execPath

The absolute file path to the executable file of the current process on the host operating system.

Usage example

1
2

const process = require('process');
console.println(process.execPath);

pid

The process ID of the current process. The value type is number and represents the process ID.

Usage example

1
2

const process = require('process');
console.println(process.pid);

ppid

The process ID of the parent process. The value type is number and represents the parent process ID.

Usage example

1
2

const process = require('process');
console.println(process.ppid);

platform

A string that identifies the operating system platform of the host machine. Common values include windows, linux, and darwin (macOS).

Usage example

1
2

const process = require('process');
console.println(process.platform);

arch

A string that identifies the operating system architecture of the host machine. Common values include amd64, aarch64.

Usage example

1
2

const process = require('process');
console.println(process.arch);

version

A string that identifies the JSH runtime version.

Usage example

1
2

const process = require('process');
console.println(process.version);

versions

An object that provides detailed runtime version information.

• versions.jsh: JSH runtime version string
• versions.go: Go runtime version string

Usage example

1
2
3

const process = require('process');
console.println('jsh:', process.versions.jsh);
console.println('go :', process.versions.go);

title

A string that identifies the current program.

Usage example

1
2

const process = require('process');
console.println(process.title);

stdin, stdout, stderr

Streams for stdin, stdout, and stderr.

Usage example

1
2
3
4
5
6
7
8

const process = require('process');
process.stdout.write('Enter text: ');
const text = process.stdin.readLine();
console.println('Your input:', text);

// Output:
// Enter text: hello?
// Your input: hello?

addShutdownHook()

Add a callback function that will be called at the termination of the current process.

Syntax

addShutdownHook(()=>{})

Usage example

1
2
3
4
5
6
7
8
9

const process = require('process');
process.addShutdownHook(()=>{
    console.println("shutdown hook called.");
})
console.println("running...")

// Output:
// running...
// shutdown hook called.

exit()

Exit the current process. If the code is omitted, default is 0.

Syntax

exit([code])

Usage example

1
2

const process = require('process');
process.exit(-1);

which()

Finds a JavaScript command in PATH and returns the resolved file path.

If the command does not include .js, it is added automatically.

Syntax

which(command)

Usage example

1
2

const process = require('process');
console.println(process.which('echo')); // e.g. /sbin/echo.js

expand()

Expands environment variables such as $HOME and ${HOME} in a string.

Syntax

expand(value)

Usage example

1
2
3

const process = require('process');
console.println(process.expand('$HOME/file.txt'));
console.println(process.expand('${HOME}/../lib/file.txt'));

exec()

Executes a JavaScript command file and returns its exit code.

Syntax

exec(command, ...args)

Usage example

1
2
3
4

const process = require('process');
const path = process.which('echo');
const code = process.exec(path, 'hello from exec');
console.println('exit code:', code);

execString()

Executes JavaScript source code from a string and returns its exit code.

Syntax

execString(source, ...args)

Usage example

1
2
3

const process = require('process');
const code = process.execString("console.println('hello from execString')");
console.println('exit code:', code);

dispatchEvent()

Dispatches an event to an event emitter object on the JSH event loop.

This function returns true if the event is scheduled, false if the event loop is already terminated.

Syntax

dispatchEvent(target, eventName, ...args)

Usage example

1
2
3
4

const process = require('process');
process.on('hello', (msg) => console.println(msg));
const ok = process.dispatchEvent(process, 'hello', 'from dispatchEvent');
console.println('scheduled:', ok);

now()

Returns the current time as a JavaScript date-time object.

Usage example

1
2
3

const process = require('process');
const now = process.now();
console.println(typeof now); // object

chdir()

Changes the current working directory.

If path is empty, JSH resolves it to $HOME.

Syntax

chdir(path)

Usage example

1
2
3
4

const process = require('process');
console.println('before:', process.cwd());
process.chdir('/lib');
console.println('after :', process.cwd());

cwd()

Returns the current working directory path.

Usage example

1
2

const process = require('process');
console.println(process.cwd());

nextTick()

Schedules a callback to run on the next event loop turn.

If the first argument is not a function, this call does nothing and returns undefined.

Syntax

nextTick(callback, ...args)

Usage example

1
2
3

const process = require('process');
console.println('main');
process.nextTick((a, b) => console.println('tick:', a, b), 'first', 'second');

memoryUsage()

Returns memory usage information as an object.

Current implementation returns placeholder numeric values (0) for all fields.

Returned fields

• rss
• heapTotal
• heapUsed
• external
• arrayBuffers

Usage example

1
2
3

const process = require('process');
const mem = process.memoryUsage();
console.println(typeof mem.rss, typeof mem.heapUsed);

cpuUsage()

Returns CPU usage information.

Current implementation returns placeholder numeric values (0) for both fields.

Returned fields

• user
• system

Usage example

1
2
3

const process = require('process');
const cpu = process.cpuUsage();
console.println(typeof cpu.user, typeof cpu.system);

uptime()

Returns process uptime in seconds as a number.

Usage example

1
2
3

const process = require('process');
const up = process.uptime();
console.println('uptime >= 0:', up >= 0);

hrtime()

Returns a high-resolution time tuple as [seconds, nanoseconds].

If a previous tuple is provided, it returns the elapsed time from that point.

Syntax

hrtime([previous])

Usage example

1
2
3
4

const process = require('process');
const start = process.hrtime();
const diff = process.hrtime([start[0], start[1]]);
console.println(Array.isArray(diff), diff.length);

Signal Events

process can receive signal events like an EventEmitter.

At the time of writing, the following signal names are supported.

• SIGHUP
• SIGINT
• SIGQUIT
• SIGABRT
• SIGKILL
• SIGUSR1
• SIGSEGV
• SIGUSR2
• SIGPIPE
• SIGALRM
• SIGTERM

Signal event listener names are case-insensitive. Event names must use the SIG-prefixed form.

For example, these names are treated the same.

• SIGTERM
• sigterm

Bare aliases such as term are not treated as signal event names. They remain ordinary EventEmitter event names.

When a listener is registered, JSH forwards the corresponding OS signal as an event. If no listener is registered, the process follows the operating system’s default signal behavior.

Usage example

1
2
3
4
5

const process = require('process');

process.on('sigint', () => {
    console.println('caught SIGINT');
});

Listener registration examples

process.on('sigterm', handler);
process.once('SIGTERM', handler);
process.addListener('sigquit', handler);

kill()

Sends a real OS signal to the given process id.

• pid must be a positive integer.
• If signal is omitted, the default is SIGTERM.
• Returns true on success.
• Returns an Error object on failure.
• signal may be either a string name or a numeric signal number.

String signal names are case-insensitive, and the SIG prefix may be omitted.

This alias support applies to process.kill().

Examples:

• SIGTERM
• term
• sigint

The following numeric signals are currently supported.

Signal 0 does not send a real signal. It can be used to check whether the target process exists and whether the caller has permission to signal it.

On Windows, process.kill(pid, 'SIGINT') does not behave like a Unix kill(2) signal send. Instead, JSH tries to deliver an interrupt-style console control event to the target process group so that the target can observe it as a SIGINT-like interruption. This is the closest available behavior to Node.js interrupt semantics on Windows, but it is best-effort. In particular, it requires a console-attached target process group and may fail when Windows cannot route the control event.

On Windows, SIGTERM, SIGQUIT, and SIGKILL are handled as termination requests rather than Unix-style distinct signals.

Syntax

kill(pid[, signal])

Usage example

1
2
3
4

const process = require('process');
console.println(process.kill(12345, 'SIGKILL'));
console.println(process.kill(12345, 'term'));
console.println(process.kill(12345, 15));

Windows interrupt example

const process = require('process');
console.println(process.kill(12345, 'SIGINT'));

If Windows cannot route the control event, process.kill() returns an Error object.

Process existence check example

1
2

const process = require('process');
console.println(process.kill(process.pid, 0));

dumpStack()

Prints the current JavaScript call stack up to the specified depth for debugging.

Syntax

dumpStack(depth)

Usage example

1
2
3
4
5

const process = require('process');
function trace() {
    process.dumpStack(5);
}
trace();