Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
nodeJS module that finds all matching files below the provided start directory
branch: master
Failed to load latest commit information.
.gitignore another updated to the reasdme which was installing the wrong module …
package.json changing name as capital letters are not allowed in npm packages

Find Files

a simple search utility that will return any file whose name includes the provided search term

Install With npm

npm install findFiles

require it in node

var finder = require('find-files');

Use it

finder(value, options, callback);


  • value - string

    • your search term as a string, findFiles will convert your string to a regex for testing against file names so 'colou?r' would match any files that had either the English or American spelling of the word colour.
  • options - Object

       root:        'string' // root of search
       requireExts: array    // Optional - only return files which match extensions contained in array
       ignoreDirs:  array    // Optional - don't include directories contained in array
  • callback - Function - the callback is passed one argument which is an array of objects as below
       name: fileName,
       filepath: absolute path of the file including filename
Something went wrong with that request. Please try again.