@jcbhmr/exec

exec(3) for JavaScript

🐧 Ergonomic exec(3) for JavaScript

// Replaces the current process with a new one. exec("node", ["--version"], { cwd: "/home/someone_else/projects", env: { HELLO: "WORLD" }, uid: 1234, });

🐧 Works on Linux, macOS, BSDs, and more
🛑 Does not work on Windows
👶 Same arguments as node:child_process spawn

Installation

npm install @jcbhmr/exec

⚠️ This package requires a Unix-like OS (Linux, macOS, etc.). Windows is not supported. For an isomorphic cross-platform solution, consider using @jcbhmr/cross-exec.

Usage

// Unix-like operating systems ONLY.
import exec from "@jcbhmr/exec";

exec("node", ["--version"]);

Development

If you're on Windows you must use WSL to develop this package.

TODOs

• Implement fd rearrangement according to the stdio options. Right now it just inherits.
• When Deno adds process.execve() support, use that instead of FFI. https://github.com/denoland/deno/issues/29017
• When Bun adds process.execve() support, use that instead of FFI.