get-all-files

Install

``sh
$ npm i get-all-files
`

Usage

`js
import { getAllFiles, getAllFilesSync } from 'get-all-files'

// Lazily iterate over filenames asynchronously
for await (const filename of getAllFiles(path/to/dir/or/file)) {
// Could break early on some condition and get-all-files
// won't have unnecessarily accumulated the filenames in an array
console.log(filename)
}

// Get array of filenames asynchronously
console.log(await getAllFiles(path/to/dir/or/file).toArray())

// Lazily iterate over filenames synchronously
for (const filename of getAllFilesSync(path/to/dir/or/file)) {
// Could break early on some condition and get-all-files
// won't have unnecessarily accumulated the filenames in an array
console.log(filename)
}

// Get array of filenames synchronously
console.log(getAllFilesSync(path/to/dir/or/file).toArray())
`

API

$3

#### getAllFiles(path[, options])

Returns a lazy
async iterable/iterator
that asynchronously iterates over the file paths recursively found at path in
no particular order.

Calling toArray on the returned value returns a promise that resolves to an
array of the file paths.

#### getAllFilesSync(path[, options])

Returns a lazy
iterable/iterator
that iterates over the file paths recursively found at path in no particular
order.

Calling toArray on the returned value returns an array of the file paths.

$3

#### path

Type: string

A path to a file or directory to recursively find files in.

#### options

Type: object

##### Properties

###### resolve

Type: boolean\
Default: false

Whether to resolve paths to absolute paths (relative to process.cwd()).

###### isExcludedDir

Type: (dirname: string) => boolean\
Default: () => false

A predicate that determines whether the directory with the given dirname
should be crawled. There is no isExcludedFile option because you can exclude
files by checking conditions while lazily iterating usinggetAllFiles.sync or
getAllFiles.async`.

Contributing

Stars are always welcome!

For bugs and feature requests,
please create an issue.

License

MIT ©
Tomer Aberbach