Skip to content

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

New Course Coming Soon:

Get Really Good at Git

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')
Are you intimidated by Git? Can’t figure out merge vs rebase? Are you afraid of screwing up something any time you have to do something in Git? Do you rely on ChatGPT or random people’s answer on StackOverflow to fix your problems? Your coworkers are tired of explaining Git to you all the time? Git is something we all need to use, but few of us really master it. I created this course to improve your Git (and GitHub) knowledge at a radical level. A course that helps you feel less frustrated with Git. Launching Summer 2024. Join the waiting list!
→ Get my Node.js Handbook
→ Read my Node.js Tutorial on The Valley of Code

Here is how can I help you: