Skip to content

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

License

Notifications You must be signed in to change notification settings

popod/recursive-readdir

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

recursive-readdir

Build Status

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

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

Usage

var recursive = require('recursive-readdir');

recursive('some/path', function (err, files) {
  // Files is an array of filename
  console.log(files);
});

It can also take a list of files to ignore.

var recursive = require('recursive-readdir');

// ignore files named 'foo.cs' or files that end in '.html'.
recursive('some/path', ['foo.cs', '*.html'], function (err, files) {
  // Files is an array of filename
  console.log(files);
});

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

var recursive = require('recursive-readdir');

function ignoreFunc(file, stats) {
  // `file` is the absolute path to the file, and `stats` is an `fs.Stats`
  // object returned from `fs.lstat()`.
  return stats.isDirectory() && path.basename(file) == "test";
}

// Ignore files named 'foo.cs' and descendants of directories named test
recursive('some/path', ['foo.cs', ignoreFunc], function (err, files) {
  // Files is an array of filename
  console.log(files);
});

The ignore strings support Glob syntax via minimatch.

Options

recursive('some/path', options, callback)

Option can be

  • an array of files to ignore
  • an object with one or more property:
    • "ignores": [] -> an array of files to ignore
    • "forceContinue": true/false -> a boolean. true to return files even if errors occures with fs.stat (if symbolic links are broken)

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%