Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including recursive-readdir with all npm packages installed. Try it out:

var recursiveReaddir = require("recursive-readdir")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

recursive-readdir v2.2.2

Get an array of all files in a directory and subdirectories.


Build Status

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.


npm install recursive-readdir


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

recursive("some/path", function (err, files) {
  // `files` is an array of file paths

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) {

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 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) {


You can omit the callback and return a promise instead.

  function(files) {
    console.log("files are", files);
  function(error) {
    console.error("something exploded", error);

The ignore strings support Glob syntax via minimatch.


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free