Sha256: 122f923f150a3e699650c6918a5601fb19002ee69fecc3e080bcafd2302097fe
Contents?: true
Size: 1.8 KB
Versions: 2
Compression:
Stored size: 1.8 KB
Contents
# del [](https://travis-ci.org/sindresorhus/del)
> Delete files/folders using [globs](https://github.com/isaacs/minimatch#usage)
Pretty much [rimraf](https://github.com/isaacs/rimraf) with a Promise API and support for multiple files and globbing. It also protects you against deleting the current working directory and above.
## Install
```
$ npm install --save del
```
## Usage
```js
var del = require('del');
del(['tmp/*.js', '!tmp/unicorn.js']).then(function (paths) {
console.log('Deleted files/folders:\n', paths.join('\n'));
});
```
## Beware
The glob pattern `**` matches all children and *the parent*.
So this won't work:
```js
del.sync(['public/assets/**', '!public/assets/goat.png']);
```
You have to explicitly ignore the parent directories too:
```js
del.sync(['public/assets/**', '!public/assets', '!public/assets/goat.png']);
```
Suggestions on how to improve this welcome!
## API
### del(patterns, [options])
Returns a promise that resolves to an array of deleted paths.
### del.sync(patterns, [options])
Returns an array of deleted paths.
#### patterns
Type: `string`, `array`
See supported minimatch [patterns](https://github.com/isaacs/minimatch#usage).
- [Pattern examples with expected matches](https://github.com/sindresorhus/multimatch/blob/master/test.js)
- [Quick globbing pattern overview](https://github.com/sindresorhus/multimatch#globbing-patterns)
#### options
Type: `object`
See the `node-glob` [options](https://github.com/isaacs/node-glob#options).
#### options.force
Type: `boolean`
Default: `false`
Allow deleting the current working directory and files/folders outside it.
## CLI
See [trash](https://github.com/sindresorhus/trash).
## License
MIT © [Sindre Sorhus](http://sindresorhus.com)
Version data entries
2 entries across 2 versions & 1 rubygems