Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fabioricali/readdirsync2

readdirSync with some useful options: recursively, exclude name and ext, get only file or directory.
https://github.com/fabioricali/readdirsync2

javascript node-js readdir readdirsync recursive

Last synced: 19 days ago
JSON representation

readdirSync with some useful options: recursively, exclude name and ext, get only file or directory.

Awesome Lists containing this project

README

        


readdirsync2


readdirSync with some useful options: recursively, exclude name and ext, get only file or directory.







## Installation

```
npm install readdirsync2 --save
```

# Example

#### Basic usage

```javascript
const readdirSync = require('readdirsync2');
readdirSync('./foo/bar');
```

#### Get only files

```javascript
readdirSync('./foo/bar', {only: 'file'});
```

#### Get only directories

```javascript
readdirSync('./foo/bar', {only: 'directory'});
```

#### Disable recursive mode

```javascript
readdirSync('./foo/bar', {recursive: false});
```

#### Ignore files with extension

```javascript
readdirSync('./foo/bar', {ignoreExt: ['.js', '.txt']});
```

#### Ignore files or directories with name

```javascript
readdirSync('./foo/bar', {ignoreName: ['index.js', 'my-folder']});
```

### API

## readdirSync(dir, [opts]) ⇒ Array
Read directory content

**Kind**: global function



ParamTypeDefaultDescription


dirstring

directory path


[opts]Object

options


[opts.ignoreExt]Array[]

an array of extensions to ignore, eg: '.txt'


[opts.ignoreName]Array[]

an array of filename or directory to ignore, eg: 'index.js'


[opts.only]string

get file or directory or both. The value can be: file or directory


[opts.recursive]booleantrue

lookup also in nested directories

## Changelog
You can view the changelog here

## License
readdirsync2 is open-sourced software licensed under the MIT license

## Authors
Fabio Ricali