Readdir-on-steroids NPM

readdir-on-steroids

Recursively read the contents of a directory.

Installation

npm install readdir-on-steroids

Usage

import readdir from "readdir-on-steroids";

const directory = process.argv[3] || ".";

// only list files
function listFilter(path, stats) {
  return stats.isFile();
}

// don't traverse the .git, lib, node_modules or .vscode directories
function walkFilter(path, stats) {
  return (
    !/\.git$/.test(path) &&
    !/lib/.test(path) &&
    !/node_modules/.test(path) &&
    !/\.vscode/.test(path)
  );
}

readdir(directory, { listFilter, walkFilter }).then(
  paths => console.log(paths.join("\n")),
  error => console.error(error)
);

Output:

.gitignore
README.md
examples/index.ts
package.json
src/__mocks__/fs.ts
src/index.test.ts
src/index.ts
yarn.lock

API

readdir(directory: string, options?: Options): Promise<string[]>

Parameter	Type	Required	Default	Description
`directory`	`string`	✓		The directory to read.
`options`	`Options`		`{}`	The options.

Options

Parameter	Type	Default	Description
`concurrency`	`number`	4	The maximum number of concurrent calls to `readdir`.
`listFilter`	`(path: string, stats: Stats) => boolean`		A function filtering the paths that will be returned.
`walkFilter`	`(path: string, stats: Stats) => boolean`		A function filtering the paths that will be walked.