@rowanmanning/list-all-files

List all files in a directory recursively.

[!WARNING] This library will be deprecated in April 2026 to coincide with the end-of-life date for Node.js 20. This is because the native fs.glob and fs.globSync methods in Node.js 22 and above provide the same functionality.

Table of Contents

• Requirements
• Usage
• Contributing
• License

Requirements

This library requires the following to run:

• Node.js 18+

Usage

Install with npm:

npm install @rowanmanning/list-all-files

Load the library into your code with a require call:

const listAllFiles = require('@rowanmanning/list-all-files');

Asynchronous Interface

List all files in a directory asynchronously, using promises or async/await:

listAllFiles('./directory-path').then(files => {
    // files is an array of strings, each being the path to a file
});

or

const files = await listAllFiles('./directory-path');
// files is an array of strings, each being the path to a file

Synchronous Interface

List all files in a directory synchronously:

const files = listAllFiles.sync('./directory-path');
// files is an array of strings, each being the path to a file

Contributing

The contributing guide is available here. All contributors must follow this library's code of conduct.

License

Licensed under the MIT license. Copyright © 2020, Rowan Manning