Working with Files: How to use the Node.js fs module with async/await

Join the AI Workshop to learn more about AI and how it can be applied to web development. Next cohort February 1st, 2026

The AI-first Web Development BOOTCAMP cohort starts February 24th, 2026. 10 weeks of intensive training and hands-on projects.


Node.js built-in modules famously are not promise-based.

This is for historical reasons, as those modules were created before promises were a thing.

We’ve had promisify for quite some time, but I recently found out Node.js provides a new API that’s promise-based.

I thought it was new but it’s been introduced in Node.js 10 (2018, it’s been a while!).

At the moment it only works for the fs built-in module.

I’m not sure if this will be ported to other native modules soon.

Here’s how to use it:

import * as fs from 'node:fs/promises';

| Note the node:fs convention which can be now used to identify native modules

Now you can use any of the fs methods using promises or await:

const posts = await fs.readdir('content')

Lessons in this unit:

0: Introduction
1: How to check if a file exists in Node.js
2: How to create an empty file in Node.js
3: How to get the names of all the files in a folder in Node
4: How to get the last updated date of a file using Node.js
5: How to remove a file with Node.js
6: How to write a JSON object to file in Node.js
7: How to empty a folder in Node.js
8: Working with file descriptors in Node
9: Node File Paths
10: Node file stats
11: Working with folders in Node
12: ▶︎ How to use the Node.js fs module with async/await
13: How to get the current folder in Node
14: How to get the file extension in Node.js from the MIME type
15: How to get the file extension in Node.js
16: How to list files in a folder in Node
17: How to mass rename files in Node.js
18: Node.js get all files in a folder recursively
19: Incrementing multiple folders numbers at once using Node.js
20: Save some text to a file in Node.js