scan-dir-recursive

Scan-dir-recursive is a small library that allows you to list all files in a directory recursively with the possibility of ignoring some.

Installation

npm install scan-dir-recursive

Getting started

const scan = require("scan-dir-recursive");

scan(__dirname, function(files){
	console.log("Files:\n", files.join("\n"));
});

Api documentation

Async or sync

By default, a scan is done asynchronously but it is possible to do them synchronously too.

// Async
const scanAsync = require("scan-dir-recursive");
// or
const scanAsync = require("scan-dir-recursive/async");

// Sync
const scanSync = require("scan-dir-recursive/sync");

scanDirRecursive(directory, done, ignore)

• directory:String - Absolute path to the directory to scan
• done:Function - Function to call when the scan is complete. Receive an Array of filenames as an argument
• [ignore:Array] - Array of files to ignore

Promise

It is possible to use the async version with a javascript Promise.

const scan = require("scan-dir-recursive/promise");

scan(__dirname, IGNORED)
	.then(function(files){
		console.log("Files:\n", files.join("\n"));
	});

Notice that the done parameter is omitted since it is replaced by the Promise.

scanDirRecursive(directory, ignore)

• directory:String - Absolute path to the directory to scan
• [ignore:Array] - Array of files to ignore

Returns a Promise that receive an Array of filenames when it resolve

Absolute path or relative path

By default, the files are listed with their absolute path. It is possible to get a path relative to the specified directory by using the relative version of the script.

const DIR = "/home/myUser/myProject/src";

// Absolute path

const absolute = require("scan-dir-recursive");

absolute(DIR, function(files){
	console.log(files.join("\n"));
	// "/home/myUser/myProject/src/file.js"
	// "/home/myUser/myProject/src/someDir/other.js"
});

// Relative path

const relative = require("scan-dir-recursive/relative");

relative(DIR, function(files){
	console.log(files.join("\n"));
	// "file.js"
	// "someDir/other.js"
});

Ignoring files

You can specify an Array of filenames or glob pattern to ignore in the results.
Assuming we have the following directory structure in /home/myUser/myProject/src

src/
   |- a.js 
   |- b
   |  |-- b1/
   |  |     |-- b1.js
   |  |-- b2/
   |        |-- b2.js

When we run the following, the b/b1 branch and all its content will be ignored.

const path = require("path");
const scan = require("scan-dir-recursive");

const DIR = "/home/myUser/myProject/src";

const IGNORED = [
	path.resolve(DIR, "b/b1"), 	// Ignored with absolute path
	"b/b1" 						// Ignored with relative path
	"**/b/b1/**"                // Ignored with glob pattern
];

function onComplete(files){
	console.log(files);
}

scan(DIR, onComplete, IGNORED);
// [
//	 "a.js",
//	 "b/b.js",
//	 "b/b2/b2.js"
// ]

// Ignored: "b/b1/b1.js",

Glob patterns are tested with the minimatch module. See their documentation for more information on how to use glob patterns.

Tests

Test can be run by using the test command:

npm run test

Coverage data can also be generated by running the coverage command:

npm run coverage

To view the coverage report, open coverage/lcov-report/index.html in the browser of your choice.