A simple Node module for recursively listing all files in a directory, or in any subdirectories synchronously.

It does not list 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-synchronous

Usage

1var recursive = require('recursive-readdir-synchronous');
2// Files is an array of filename
3var files = recursive('some/path');

It can also take a list of files to ignore.

1var recursive = require('recursive-readdir-synchronous');
2
3// ignore files named 'foo.cs' or files that end in '.html'.
4// Files is an array of filename
5var files = recursive('some/path', ['foo.cs', '*.html']);

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

1var recursive = require('recursive-readdir-synchronous');
2
3function ignoreFunc(file, stats) {
4  // `file` is the absolute 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
10// Files is an array of filename
11var files = recursive('some/path', ['foo.cs', ignoreFunc]);

The ignore strings support Glob syntax via minimatch.