npmpackage.info

Gathering detailed insights and metrics for recursive-readdir

Other packages similar to recursive-readdir

fs-readdir-recursive

1.1.0

Recursively read a directory

readdir-glob

2.0.1

Recursive fs.readdir with streaming API and glob filtering.

readdirp

4.1.2

Recursive version of fs.readdir with small RAM & CPU footprint.

recursive-readdir-sync

1.0.6

NodeJS library to recursively read a directory path's contents synchronously

Gathering detailed insights and metrics for recursive-readdir

recursive-readdir - 2.2.3 | npmpackage.info

recursive-readdir

Node.js module to list all files in a directory or any subdirectories.

2.2.3

345

MIT

JavaScript

5.69 kB

2.3

Installations

npm install recursive-readdir

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=6.0.0

Node Version

18.6.0

NPM Version

8.13.2 Score

99.4

Supply Chain

87.9

Quality

78.1

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

8

Total

46

Closed

14

Merged

24

Issues

Open

19

Total

48

Closed

29

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

jergason

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

345 Stars

105 Commits

87 Forks

3 Watchers

8 Branches

21 Contributors

Updated on Jun 25, 2025

Maintainers

View All 21 Contributors

Package Meta Information

Latest Version

2.2.3

Package Id

recursive-readdir@2.2.3

Unpacked Size

5.69 kB

Size

2.42 kB

File Count

NPM Version

8.13.2

Node Version

18.6.0

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

minimatch

Dev Dependencies

mocha

recursive-readdir

Recursively list all files in a directory and its subdirectories. It does not list the directories themselves.

Because it uses fs.readdir, which calls readdir under the hood on OS X and Linux, the order of files inside directories is not guaranteed.

Installation

npm install recursive-readdir

Usage

1var recursive = require("recursive-readdir");
2
3recursive("some/path", function (err, files) {
4  // `files` is an array of file paths
5  console.log(files);
6});

It can also take a list of files to ignore.

1var recursive = require("recursive-readdir");
2
3// ignore files named "foo.cs" or files that end in ".html".
4recursive("some/path", ["foo.cs", "*.html"], function (err, files) {
5  console.log(files);
6});

You can also pass functions which are called to determine whether or not to ignore a file:

1var recursive = require("recursive-readdir");
2
3function ignoreFunc(file, stats) {
4  // `file` is the path to the file, and `stats` is an `fs.Stats`
5  // object returned from `fs.lstat()`.
6  return stats.isDirectory() && path.basename(file) == "test";
7}
8
9// Ignore files named "foo.cs" and descendants of directories named test
10recursive("some/path", ["foo.cs", ignoreFunc], function (err, files) {
11  console.log(files);
12});

Promises

You can omit the callback and return a promise instead.

1var recursive = require("recursive-readdir");
2
3recursive("some/path").then(
4  function(files) {
5    console.log("files are", files);
6  },
7  function(error) {
8    console.error("something exploded", error);
9  }
10);

The ignore strings support Glob syntax via minimatch.

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

4

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.3

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More