Creating and removing directories in Node.js

Introduction

We create directories to organize files and remove them when they are no longer needed. This helps keep your computer tidy and your projects organized.

When you want to save files in a new folder for a project.

When you need to clean up temporary folders after a task is done.

When your program needs to prepare a place to store user uploads.

When you want to delete old folders that are empty or no longer useful.

Syntax

Node.js

import { mkdir, rmdir } from 'node:fs/promises';

// Create a directory
await mkdir(path, { recursive: true });

// Remove a directory
await rmdir(path);

mkdir creates a new directory. The recursive: true option lets you create nested folders at once.

rmdir removes an empty directory. It will fail if the directory has files inside.

Examples

This creates a folder named myFolder in the current location.

Node.js

await mkdir('myFolder');

This creates parent and inside it child folder, even if parent does not exist yet.

Node.js

await mkdir('parent/child', { recursive: true });

This removes the folder named myFolder if it is empty.

Node.js

await rmdir('myFolder');

Sample Program

This program creates a folder called testDir and then removes it. It prints messages to show what it did.

Node.js

import { mkdir, rmdir } from 'node:fs/promises';

async function manageDirectories() {
  const folder = 'testDir';

  // Create a directory
  await mkdir(folder, { recursive: true });
  console.log(`Created directory: ${folder}`);

  // Remove the directory
  await rmdir(folder);
  console.log(`Removed directory: ${folder}`);
}

manageDirectories();

Important Notes

Trying to remove a directory that has files will cause an error. You must delete files first or use other methods.

Using recursive: true with mkdir helps create nested folders easily.

Always handle errors in real programs to avoid crashes when folders exist or don't exist.

Summary

Use mkdir to create folders and rmdir to remove empty folders.

The recursive option lets you create nested folders in one step.

Removing folders only works if they are empty; otherwise, delete files first.

Practice

1. Which Node.js method is used to create a new directory?

easy

A. fs.createDir()

B. fs.rmdir()

C. fs.deleteDir()

D. fs.mkdir()

Solution

1. Step 1: Understand directory creation methods

   Node.js provides fs.mkdir() to create directories.

2. Step 2: Differentiate from removal methods

   fs.rmdir() is for removing directories, not creating.

3. Final Answer:

   fs.mkdir() -> Option D

4. Quick Check:

   Create directory = fs.mkdir() [OK]

Hint: Use fs.mkdir() to create folders, not fs.rmdir() [OK]

Common Mistakes:

• Confusing fs.mkdir() with fs.rmdir()
• Using non-existent fs.createDir()
• Trying to use fs.deleteDir() which doesn't exist

2. Which of the following is the correct syntax to create a nested directory parent/child in Node.js?

easy

A. fs.mkdir('parent/child', callback)

B. fs.mkdir('parent/child', { recursive: true }, callback)

C. fs.rmdir('parent/child', { recursive: true }, callback)

D. fs.mkdir('parent/child', { nested: true }, callback)

Solution

1. Step 1: Recognize recursive option for nested folders

   To create nested directories, use { recursive: true } option with fs.mkdir().

2. Step 2: Confirm correct method and options

   fs.mkdir with recursive true creates all needed folders; fs.rmdir is for removal, and nested option doesn't exist.

3. Final Answer:

   fs.mkdir('parent/child', { recursive: true }, callback) -> Option B

4. Quick Check:

   Nested folders need recursive: true [OK]

Hint: Use { recursive: true } with fs.mkdir for nested folders [OK]

Common Mistakes:

• Omitting recursive option for nested directories
• Using fs.rmdir instead of fs.mkdir
• Using incorrect option name like nested

3. What will happen if you run the following code snippet in Node.js?

const fs = require('fs');
fs.rmdir('myFolder', (err) => {
  if (err) console.log('Error:', err.message);
  else console.log('Folder removed');
});

Assuming myFolder contains files.

medium

A. Folder is removed successfully

B. Code throws a syntax error

C. Error logged because folder is not empty

D. Folder is renamed instead of removed

Solution

1. Step 1: Understand fs.rmdir behavior

   fs.rmdir only removes empty directories; if folder has files, it throws an error.

2. Step 2: Analyze error handling in callback

   The callback logs error message if removal fails due to non-empty folder.

3. Final Answer:

   Error logged because folder is not empty -> Option C

4. Quick Check:

   Non-empty folder removal = error [OK]

Hint: fs.rmdir fails if folder has files; must delete files first [OK]

Common Mistakes:

• Assuming fs.rmdir removes non-empty folders
• Expecting folder rename instead of removal
• Thinking code throws syntax error

4. Identify the error in this code snippet that tries to remove a directory:

const fs = require('fs');
fs.rmdir('testDir', { recursive: true }, (err) => {
  if (err) throw err;
  console.log('Directory removed');
});

medium

A. fs.rmdir does not support recursive option

B. Callback function is missing

C. fs.rmdir cannot remove directories

D. Directory path must be absolute

Solution

1. Step 1: Check fs.rmdir method options

   fs.rmdir does not support the recursive option; fs.rm should be used instead for recursive removal.

2. Step 2: Understand correct method for recursive removal

   Use fs.rm with { recursive: true } to remove non-empty directories recursively.

3. Final Answer:

   fs.rmdir does not support recursive option -> Option A

4. Quick Check:

   Recursive removal needs fs.rm, not fs.rmdir [OK]

Hint: Use fs.rm for recursive removal, not fs.rmdir [OK]

Common Mistakes:

• Using recursive option with fs.rmdir
• Thinking callback is missing
• Believing directory path must be absolute

5. You want to create a nested directory projects/app/src and then remove it completely including all files inside. Which sequence of Node.js methods should you use?

hard

A. Use fs.mkdir with { recursive: true } to create, then fs.rm with { recursive: true, force: true } to remove

B. Use fs.mkdir without options to create, then fs.rmdir to remove

C. Use fs.mkdir with { recursive: true } to create, then fs.rmdir to remove

D. Use fs.mkdir to create, then fs.unlink to remove

Solution

1. Step 1: Create nested directories

   Use fs.mkdir with { recursive: true } to create nested folders in one step.

2. Step 2: Remove directory with all contents

   Use fs.rm with { recursive: true, force: true } to delete directory and all files inside safely.

3. Final Answer:

   Use fs.mkdir with { recursive: true } to create, then fs.rm with { recursive: true, force: true } to remove -> Option A

4. Quick Check:

   Nested create + recursive remove = fs.mkdir + fs.rm [OK]

Hint: Create nested with mkdir recursive, remove all with rm recursive force [OK]

Common Mistakes:

• Using fs.rmdir to remove non-empty directories
• Omitting recursive option when creating nested folders
• Using fs.unlink which deletes files, not folders