A deep deletion module for node (like
The UNIX command
rm -rf for node.
npm install rimraf, or just drop rimraf.js somewhere.
The callback will be called with an error if there is one. Certain errors are handled for you:
ENOTEMPTY- rimraf will back off a maximum of
opts.maxBusyTriestimes before giving up, adding 100ms of wait between each attempt. The default
ENOENT- If the file doesn't exist, rimraf will return successfully, since your desired outcome is already the case.
readdirrequires opening a file descriptor, it's possible to hit
EMFILEif 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.emfileWaitms, which defaults to 1000.
It can remove stuff synchronously, too. But that's not so good. Use the async API. It's better.
If installed with
npm install rimraf -g it can be used as a global
rimraf <path> which is useful for cross platform support.
If you need to create a directory recursively, check out mkdirp.