'use strict'
|
|
const fs = require('graceful-fs')
|
const path = require('path')
|
const assert = require('assert')
|
|
const isWindows = (process.platform === 'win32')
|
|
function defaults (options) {
|
const methods = [
|
'unlink',
|
'chmod',
|
'stat',
|
'lstat',
|
'rmdir',
|
'readdir'
|
]
|
methods.forEach(m => {
|
options[m] = options[m] || fs[m]
|
m = m + 'Sync'
|
options[m] = options[m] || fs[m]
|
})
|
|
options.maxBusyTries = options.maxBusyTries || 3
|
}
|
|
function rimraf (p, options, cb) {
|
let busyTries = 0
|
|
if (typeof options === 'function') {
|
cb = options
|
options = {}
|
}
|
|
assert(p, 'rimraf: missing path')
|
assert.strictEqual(typeof p, 'string', 'rimraf: path should be a string')
|
assert.strictEqual(typeof cb, 'function', 'rimraf: callback function required')
|
assert(options, 'rimraf: invalid options argument provided')
|
assert.strictEqual(typeof options, 'object', 'rimraf: options should be object')
|
|
defaults(options)
|
|
rimraf_(p, options, function CB (er) {
|
if (er) {
|
if ((er.code === 'EBUSY' || er.code === 'ENOTEMPTY' || er.code === 'EPERM') &&
|
busyTries < options.maxBusyTries) {
|
busyTries++
|
const time = busyTries * 100
|
// try again, with the same exact callback as this one.
|
return setTimeout(() => rimraf_(p, options, CB), time)
|
}
|
|
// already gone
|
if (er.code === 'ENOENT') er = null
|
}
|
|
cb(er)
|
})
|
}
|
|
// Two possible strategies.
|
// 1. Assume it's a file. unlink it, then do the dir stuff on EPERM or EISDIR
|
// 2. Assume it's a directory. readdir, then do the file stuff on ENOTDIR
|
//
|
// Both result in an extra syscall when you guess wrong. However, there
|
// are likely far more normal files in the world than directories. This
|
// is based on the assumption that a the average number of files per
|
// directory is >= 1.
|
//
|
// If anyone ever complains about this, then I guess the strategy could
|
// be made configurable somehow. But until then, YAGNI.
|
function rimraf_ (p, options, cb) {
|
assert(p)
|
assert(options)
|
assert(typeof cb === 'function')
|
|
// sunos lets the root user unlink directories, which is... weird.
|
// so we have to lstat here and make sure it's not a dir.
|
options.lstat(p, (er, st) => {
|
if (er && er.code === 'ENOENT') {
|
return cb(null)
|
}
|
|
// Windows can EPERM on stat. Life is suffering.
|
if (er && er.code === 'EPERM' && isWindows) {
|
return fixWinEPERM(p, options, er, cb)
|
}
|
|
if (st && st.isDirectory()) {
|
return rmdir(p, options, er, cb)
|
}
|
|
options.unlink(p, er => {
|
if (er) {
|
if (er.code === 'ENOENT') {
|
return cb(null)
|
}
|
if (er.code === 'EPERM') {
|
return (isWindows)
|
? fixWinEPERM(p, options, er, cb)
|
: rmdir(p, options, er, cb)
|
}
|
if (er.code === 'EISDIR') {
|
return rmdir(p, options, er, cb)
|
}
|
}
|
return cb(er)
|
})
|
})
|
}
|
|
function fixWinEPERM (p, options, er, cb) {
|
assert(p)
|
assert(options)
|
assert(typeof cb === 'function')
|
if (er) {
|
assert(er instanceof Error)
|
}
|
|
options.chmod(p, 0o666, er2 => {
|
if (er2) {
|
cb(er2.code === 'ENOENT' ? null : er)
|
} else {
|
options.stat(p, (er3, stats) => {
|
if (er3) {
|
cb(er3.code === 'ENOENT' ? null : er)
|
} else if (stats.isDirectory()) {
|
rmdir(p, options, er, cb)
|
} else {
|
options.unlink(p, cb)
|
}
|
})
|
}
|
})
|
}
|
|
function fixWinEPERMSync (p, options, er) {
|
let stats
|
|
assert(p)
|
assert(options)
|
if (er) {
|
assert(er instanceof Error)
|
}
|
|
try {
|
options.chmodSync(p, 0o666)
|
} catch (er2) {
|
if (er2.code === 'ENOENT') {
|
return
|
} else {
|
throw er
|
}
|
}
|
|
try {
|
stats = options.statSync(p)
|
} catch (er3) {
|
if (er3.code === 'ENOENT') {
|
return
|
} else {
|
throw er
|
}
|
}
|
|
if (stats.isDirectory()) {
|
rmdirSync(p, options, er)
|
} else {
|
options.unlinkSync(p)
|
}
|
}
|
|
function rmdir (p, options, originalEr, cb) {
|
assert(p)
|
assert(options)
|
if (originalEr) {
|
assert(originalEr instanceof Error)
|
}
|
assert(typeof cb === 'function')
|
|
// try to rmdir first, and only readdir on ENOTEMPTY or EEXIST (SunOS)
|
// if we guessed wrong, and it's not a directory, then
|
// raise the original error.
|
options.rmdir(p, er => {
|
if (er && (er.code === 'ENOTEMPTY' || er.code === 'EEXIST' || er.code === 'EPERM')) {
|
rmkids(p, options, cb)
|
} else if (er && er.code === 'ENOTDIR') {
|
cb(originalEr)
|
} else {
|
cb(er)
|
}
|
})
|
}
|
|
function rmkids (p, options, cb) {
|
assert(p)
|
assert(options)
|
assert(typeof cb === 'function')
|
|
options.readdir(p, (er, files) => {
|
if (er) return cb(er)
|
|
let n = files.length
|
let errState
|
|
if (n === 0) return options.rmdir(p, cb)
|
|
files.forEach(f => {
|
rimraf(path.join(p, f), options, er => {
|
if (errState) {
|
return
|
}
|
if (er) return cb(errState = er)
|
if (--n === 0) {
|
options.rmdir(p, cb)
|
}
|
})
|
})
|
})
|
}
|
|
// this looks simpler, and is strictly *faster*, but will
|
// tie up the JavaScript thread and fail on excessively
|
// deep directory trees.
|
function rimrafSync (p, options) {
|
let st
|
|
options = options || {}
|
defaults(options)
|
|
assert(p, 'rimraf: missing path')
|
assert.strictEqual(typeof p, 'string', 'rimraf: path should be a string')
|
assert(options, 'rimraf: missing options')
|
assert.strictEqual(typeof options, 'object', 'rimraf: options should be object')
|
|
try {
|
st = options.lstatSync(p)
|
} catch (er) {
|
if (er.code === 'ENOENT') {
|
return
|
}
|
|
// Windows can EPERM on stat. Life is suffering.
|
if (er.code === 'EPERM' && isWindows) {
|
fixWinEPERMSync(p, options, er)
|
}
|
}
|
|
try {
|
// sunos lets the root user unlink directories, which is... weird.
|
if (st && st.isDirectory()) {
|
rmdirSync(p, options, null)
|
} else {
|
options.unlinkSync(p)
|
}
|
} catch (er) {
|
if (er.code === 'ENOENT') {
|
return
|
} else if (er.code === 'EPERM') {
|
return isWindows ? fixWinEPERMSync(p, options, er) : rmdirSync(p, options, er)
|
} else if (er.code !== 'EISDIR') {
|
throw er
|
}
|
rmdirSync(p, options, er)
|
}
|
}
|
|
function rmdirSync (p, options, originalEr) {
|
assert(p)
|
assert(options)
|
if (originalEr) {
|
assert(originalEr instanceof Error)
|
}
|
|
try {
|
options.rmdirSync(p)
|
} catch (er) {
|
if (er.code === 'ENOTDIR') {
|
throw originalEr
|
} else if (er.code === 'ENOTEMPTY' || er.code === 'EEXIST' || er.code === 'EPERM') {
|
rmkidsSync(p, options)
|
} else if (er.code !== 'ENOENT') {
|
throw er
|
}
|
}
|
}
|
|
function rmkidsSync (p, options) {
|
assert(p)
|
assert(options)
|
options.readdirSync(p).forEach(f => rimrafSync(path.join(p, f), options))
|
|
if (isWindows) {
|
// We only end up here once we got ENOTEMPTY at least once, and
|
// at this point, we are guaranteed to have removed all the kids.
|
// So, we know that it won't be ENOENT or ENOTDIR or anything else.
|
// try really hard to delete stuff on windows, because it has a
|
// PROFOUNDLY annoying habit of not closing handles promptly when
|
// files are deleted, resulting in spurious ENOTEMPTY errors.
|
const startTime = Date.now()
|
do {
|
try {
|
const ret = options.rmdirSync(p, options)
|
return ret
|
} catch (er) { }
|
} while (Date.now() - startTime < 500) // give up after 500ms
|
} else {
|
const ret = options.rmdirSync(p, options)
|
return ret
|
}
|
}
|
|
module.exports = rimraf
|
rimraf.sync = rimrafSync
|
