Node.js – File System Module – Read, Write, and Manage Files with fs

Introduction – What Is the File System Module in Node.js?

The File System module (fs) in Node.js allows developers to interact with the file system directly from their applications. You can read, write, delete, rename, and manage files and directories—all asynchronously or synchronously.

Whether you’re building a file uploader, a static site generator, or a logging system, the fs module is an essential part of any backend developer’s toolkit.

In this guide, you’ll learn:

• How to perform basic file and directory operations
• Use both asynchronous and synchronous APIs
• Understand file reading/writing, deleting, renaming, and checking
• Real-world code examples with output

Loading the File System Module

To use the fs module, you must first require it:

const fs = require('fs');

Reading Files – fs.readFile() (Async) & fs.readFileSync() (Sync)

Asynchronous Read:

fs.readFile('example.txt', 'utf8', (err, data) => {
  if (err) throw err;
  console.log('File content:', data);
});

Synchronous Read:

const data = fs.readFileSync('example.txt', 'utf8');
console.log('File content:', data);

Output:

File content: Hello from the file!

Writing Files – fs.writeFile() & fs.appendFile()

Overwrite File Content:

fs.writeFile('output.txt', 'New Content', (err) => {
  if (err) throw err;
  console.log('File written successfully.');
});

Append to File:

fs.appendFile('output.txt', '\nMore content', (err) => {
  if (err) throw err;
  console.log('Appended successfully.');
});

Result in output.txt:

New Content
More content

Deleting Files – fs.unlink()

fs.unlink('output.txt', (err) => {
  if (err) throw err;
  console.log('File deleted');
});

Output:

File deleted

Working with Directories

Create a Directory:

fs.mkdir('logs', (err) => {
  if (err) throw err;
  console.log('Directory created');
});

Remove a Directory:

fs.rmdir('logs', (err) => {
  if (err) throw err;
  console.log('Directory removed');
});

Rename or Move a File – fs.rename()

fs.rename('old.txt', 'new.txt', (err) => {
  if (err) throw err;
  console.log('File renamed');
});

Output:

File renamed

Check If File or Directory Exists – fs.existsSync()

if (fs.existsSync('new.txt')) {
  console.log('File exists');
}

Output:

File exists

Watch for File Changes – fs.watchFile()

fs.watchFile('example.txt', () => {
  console.log('File was changed!');
});

Great for logging or real-time sync tools.

Summary – Recap & Next Steps

The Node.js fs module enables low-level interaction with the file system using both synchronous and asynchronous methods. It’s vital for backend scripts, CLI tools, log management, and more.

Key Takeaways:

• Use readFile, writeFile, unlink, mkdir, rename, etc.
• Prefer asynchronous methods for production use
• Always include error handling for safe I/O operations

Real-world relevance:
Used in loggers, data importers, file uploaders, static site generators, and system monitors.

FAQs – Node.js File System Module

What is the difference between fs.readFile() and fs.readFileSync()?
fs.readFile() is asynchronous and non-blocking; fs.readFileSync() blocks execution until the file is read.

How to append content to a file in Node.js?
Use fs.appendFile() for adding new content to an existing file.

Can I check if a file exists without throwing an error?
Use fs.existsSync() to check safely before reading or writing.

How do I delete a directory in Node.js?
Use fs.rmdir() or fs.rm(path, { recursive: true }) in newer versions.

Is it better to use sync or async methods?
Async methods are better for production environments to avoid blocking the event loop.