rimraf

WebJar for rimraf

License	ISC
GroupId	org.webjars.npm
ArtifactId	rimraf
Last Version	3.0.2
Release Date	Sep 3, 2020
Type	jar
Description	rimraf WebJar for rimraf
Project URL	https://www.webjars.org
Source Code Management	https://github.com/isaacs/rimraf

Download rimraf

Filename	Size
rimraf-3.0.2.pom
rimraf-3.0.2.jar	9 KB
rimraf-3.0.2-sources.jar	22 bytes
rimraf-3.0.2-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/rimraf/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>rimraf</artifactId>
    <version>3.0.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/rimraf/
implementation 'org.webjars.npm:rimraf:3.0.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/rimraf/
implementation ("org.webjars.npm:rimraf:3.0.2")

Apache Buildr

'org.webjars.npm:rimraf:jar:3.0.2'

Apache Ivy

<dependency org="org.webjars.npm" name="rimraf" rev="3.0.2">
  <artifact name="rimraf" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='rimraf', version='3.0.2')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "rimraf" % "3.0.2"

Leiningen

[org.webjars.npm/rimraf "3.0.2"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.webjars.npm : glob	jar	[7.1.3,8)

Project Modules

There are no modules declared in this project.

The UNIX command rm -rf for node.

Install with npm install rimraf, or just drop rimraf.js somewhere.

API

rimraf(f, [opts], callback)

The first parameter will be interpreted as a globbing pattern for files. If you want to disable globbing you can do so with opts.disableGlob (defaults to false). This might be handy, for instance, if you have filenames that contain globbing wildcard characters.

The callback will be called with an error if there is one. Certain errors are handled for you:

• Windows: EBUSY and ENOTEMPTY - rimraf will back off a maximum of opts.maxBusyTries times before giving up, adding 100ms of wait between each attempt. The default maxBusyTries is 3.
• ENOENT - If the file doesn't exist, rimraf will return successfully, since your desired outcome is already the case.
• EMFILE - Since readdir requires opening a file descriptor, it's possible to hit EMFILE if too many file descriptors are in use. In the sync case, there's nothing to be done for this. But in the async case, rimraf will gradually back off with timeouts up to opts.emfileWait ms, which defaults to 1000.

options

• unlink, chmod, stat, lstat, rmdir, readdir, unlinkSync, chmodSync, statSync, lstatSync, rmdirSync, readdirSync

  In order to use a custom file system library, you can override specific fs functions on the options object.

  If any of these functions are present on the options object, then the supplied function will be used instead of the default fs method.

  Sync methods are only relevant for rimraf.sync(), of course.

  For example:

  var myCustomFS = require('some-custom-fs')
  
  rimraf('some-thing', myCustomFS, callback)

• maxBusyTries

  If an EBUSY, ENOTEMPTY, or EPERM error code is encountered on Windows systems, then rimraf will retry with a linear backoff wait of 100ms longer on each try. The default maxBusyTries is 3.

  Only relevant for async usage.

• emfileWait

  If an EMFILE error is encountered, then rimraf will retry repeatedly with a linear backoff of 1ms longer on each try, until the timeout counter hits this max. The default limit is 1000.

  If you repeatedly encounter EMFILE errors, then consider using graceful-fs in your program.

  Only relevant for async usage.

• glob

  Set to false to disable glob pattern matching.

  Set to an object to pass options to the glob module. The default glob options are { nosort: true, silent: true }.

  Glob version 6 is used in this module.

  Relevant for both sync and async usage.

• disableGlob

  Set to any non-falsey value to disable globbing entirely. (Equivalent to setting glob: false.)

rimraf.sync

It can remove stuff synchronously, too. But that's not so good. Use the async API. It's better.

CLI

If installed with npm install rimraf -g it can be used as a global command rimraf <path> [<path> ...] which is useful for cross platform support.

mkdirp

If you need to create a directory recursively, check out mkdirp.

Versions

Version
3.0.2 Sep 3, 2020
3.0.1 Feb 10, 2020
3.0.0 Nov 17, 2019
2.7.1 Aug 19, 2019
2.6.3 Jan 17, 2019
2.6.2 Feb 13, 2018
2.6.1 Jul 12, 2017
2.5.3 Jul 14, 2016
2.5.2 Feb 27, 2016
2.5.1 Feb 3, 2016
2.4.5 Feb 2, 2016
2.3.3 Oct 13, 2015
2.2.8 Aug 26, 2015
2.2.6 Dec 28, 2018