Skip to content

How to spawn a child process with Node.js

Find out how to spawn a child process with Node.js

Node.js provides a child_process module that provides the ability to spawn child processes.

Require the module, and get the spawn function from it:

const { spawn } = require('child_process')

then you can call spawn() passing 2 parameters.

The first parameter is the command to run.

The second parameter is an array containing a list of options.

Here's an example:

spawn('ls', ['-lh', 'test'])

In this case you run the ls command with 2 options: -lh and test. This results in the command ls -lh test, which (given that the test file exists in the same folder you run this command in), results in the details about the file:

-rw-r--r--  1 flaviocopes  staff     6B Sep 25 09:57 test

The result of the spawn() function call is an instance of the ChildProcess class that identifies the spawned child process.

Here's a slightly more complicated example, fully working. We watch the test file and whenever it's changed, we run the ls -lh command on it:

'use strict'

const fs = require('fs')
const { spawn } = require('child_process')
const filename = 'test'

fs.watch(filename, () => {
  const ls = spawn('ls', ['-lh', filename])
})

There's one thing missing. We must pipe the output from the child process to the main process, otherwise we won't see any output from it.

We do so by calling the pipe() method on the stdout property of the child process:

'use strict'

const fs = require('fs')
const { spawn } = require('child_process')
const filename = 'test'

fs.watch(filename, () => {
  const ls = spawn('ls', ['-lh', filename])
  ls.stdout.pipe(process.stdout)
})
→ Download my free Node.js Handbook!

THE VALLEY OF CODE

THE WEB DEVELOPER's MANUAL

You might be interested in those things I do:

  • Learn to code in THE VALLEY OF CODE, your your web development manual
  • Find a ton of Web Development projects to learn modern tech stacks in practice in THE VALLEY OF CODE PRO
  • I wrote 16 books for beginner software developers, DOWNLOAD THEM NOW
  • Every year I organize a hands-on cohort course coding BOOTCAMP to teach you how to build a complex, modern Web Application in practice (next edition February-March-April-May 2024)
  • Learn how to start a solopreneur business on the Internet with SOLO LAB (next edition in 2024)
  • Find me on X

Related posts that talk about node: