exec for running shell commands in Node.js

Introduction

We use exec to run commands on the computer's shell from a Node.js program. This helps us automate tasks or get system info.

You want to list files in a folder from your Node.js app.

You need to run a system command like checking disk space.

You want to automate running scripts or tools outside Node.js.

You want to get the output of a shell command to use in your program.

Syntax

Node.js

const { exec } = require('child_process');

exec('command', (error, stdout, stderr) => {
  if (error) {
    console.error(`Error: ${error.message}`);
    return;
  }
  if (stderr) {
    console.error(`Stderr: ${stderr}`);
    return;
  }
  console.log(`Output: ${stdout}`);
});

exec runs the command as a string in the shell.

The callback gets error, stdout (normal output), and stderr (error output).

Examples

This lists files in the current folder on Unix-like systems.

Node.js

const { exec } = require('child_process');

exec('ls', (error, stdout, stderr) => {
  if (!error && !stderr) {
    console.log(stdout);
  }
});

This lists files in the current folder on Windows.

Node.js

const { exec } = require('child_process');

exec('dir', (error, stdout, stderr) => {
  if (!error && !stderr) {
    console.log(stdout);
  }
});

This gets the installed Node.js version.

Node.js

const { exec } = require('child_process');

exec('node -v', (error, stdout, stderr) => {
  if (!error && !stderr) {
    console.log(`Node version: ${stdout.trim()}`);
  }
});

Sample Program

This program runs a simple shell command that prints a message. It shows how to handle errors and print the output.

Node.js

const { exec } = require('child_process');

exec('echo Hello from shell', (error, stdout, stderr) => {
  if (error) {
    console.error(`Error: ${error.message}`);
    return;
  }
  if (stderr) {
    console.error(`Stderr: ${stderr}`);
    return;
  }
  console.log(`Output: ${stdout.trim()}`);
});

Important Notes

Always handle errors to avoid your program crashing.

Be careful with user input in commands to avoid security risks.

exec runs commands asynchronously, so your program keeps running while waiting.

Summary

exec lets Node.js run shell commands easily.

Use it to automate or get info from the system.

Always check for errors and output carefully.

Practice

1. What does the exec function in Node.js primarily do?

easy

A. Runs shell commands from within a Node.js program

B. Creates a new HTTP server

C. Reads files from the filesystem

D. Starts a database connection

Solution

1. Step 1: Understand the purpose of exec

   The exec function is designed to run shell commands from Node.js code.

2. Step 2: Compare with other options

   Creating servers, reading files, or database connections are unrelated to exec.

3. Final Answer:

   Runs shell commands from within a Node.js program -> Option A

4. Quick Check:

   exec runs shell commands = B [OK]

Hint: Remember exec runs shell commands, not servers or files [OK]

Common Mistakes:

• Confusing exec with file reading functions
• Thinking exec creates servers
• Assuming exec manages databases

2. Which is the correct way to import and use exec from the child_process module in Node.js?

easy

A. import exec from 'child_process';

B. const exec = require('child_process').exec;

C. const exec = require('exec');

D. import { exec } from 'child_process';

Solution

1. Step 1: Recall Node.js import syntax for exec

   In Node.js CommonJS, exec is imported as const exec = require('child_process').exec;.

2. Step 2: Check other options for correctness

   import exec from 'child_process'; uses ES module default import incorrectly; const exec = require('exec'); tries to require a non-existent module; import { exec } from 'child_process'; is ES module named import but Node.js needs special config.

3. Final Answer:

   const exec = require('child_process').exec; -> Option B

4. Quick Check:

   CommonJS import for exec = A [OK]

Hint: Use require('child_process').exec for standard Node.js [OK]

Common Mistakes:

• Using import without Node.js ES module setup
• Requiring wrong module name
• Confusing default and named imports

3. What will the following Node.js code output if the current directory contains a file named test.txt?

const { exec } = require('child_process');
exec('ls', (error, stdout, stderr) => {
  if (error) {
    console.error(`Error: ${error.message}`);
    return;
  }
  if (stderr) {
    console.error(`Stderr: ${stderr}`);
    return;
  }
  console.log(`Output: ${stdout}`);
});

medium

A. Output: test.txt

B. Error: ls command not found

C. Stderr: Permission denied

D. No output

Solution

1. Step 1: Understand exec running 'ls'

   The command ls lists files in the current directory. If test.txt exists, it will appear in the output.

2. Step 2: Analyze callback behavior

   No error or stderr means output is printed with file names, so console logs 'Output: test.txt\n'.

3. Final Answer:

   Output: test.txt -> Option A

4. Quick Check:

   exec runs ls, outputs files = A [OK]

Hint: exec callback logs stdout if no error or stderr [OK]

Common Mistakes:

• Assuming error if command runs successfully
• Ignoring stdout content
• Confusing stderr with stdout

4. Identify the error in this Node.js code using exec:

const { exec } = require('child_process');
exec('node -v', (error, stdout, stderr) => {
  if (error) {
    console.log(error);
  }
  console.log(stdout);
});

medium

A. Callback function has wrong parameters

B. Incorrect command syntax for node version

C. Missing error return causes stdout to print even on error

D. exec is not imported correctly

Solution

1. Step 1: Check error handling logic

   The code logs error but does not return or stop, so stdout logs even if error occurs.

2. Step 2: Understand impact of missing return

   This can cause confusing output mixing error and stdout, which is not ideal.

3. Final Answer:

   Missing error return causes stdout to print even on error -> Option C

4. Quick Check:

   Missing error return causes stdout to print even on error = D [OK]

Hint: Return after error to avoid printing stdout [OK]

Common Mistakes:

• Not returning after error check
• Assuming exec import is wrong
• Thinking command syntax is incorrect

5. You want to run a shell command that lists all files but only print those containing the word 'log'. Which exec usage correctly achieves this in Node.js?

hard

A. exec('ls > grep log', (err, stdout) => { if (!err) console.log(stdout); });

B. exec('ls && grep log', (err, stdout) => { if (!err) console.log(stdout); });

C. exec('ls | find log', (err, stdout) => { if (!err) console.log(stdout); });

D. exec('ls | grep log', (err, stdout) => { if (!err) console.log(stdout); });

Solution

1. Step 1: Understand shell command chaining

   The pipe | sends output of ls to grep log to filter lines containing 'log'.

2. Step 2: Evaluate each option's command

   ls | grep log correctly pipes output to grep for filtering; ls > grep log uses redirection to create a file; ls && grep log runs sequentially without piping; ls | find log pipes to filesystem search tool unsuitable for text filtering.

3. Final Answer:

   exec('ls | grep log', (err, stdout) => { if (!err) console.log(stdout); }); -> Option D

4. Quick Check:

   Pipe output to grep for filtering = C [OK]

Hint: Use pipe (|) to filter command output with grep [OK]

Common Mistakes:

• Using && instead of | for piping output
• Misusing redirection operators
• Confusing grep with find command