// https://youtu.be/uhRWMGBjlO8?t=537 // // 1. readdir // 2. for each entry // a. if a non-empty directory, recurse // b. if an empty directory, move to random hidden file name in $TEMP // c. unlink/rmdir $TEMP // // This works around the fact that unlink/rmdir is non-atomic and takes // a non-deterministic amount of time to complete. // // However, it is HELLA SLOW, like 2-10x slower than a naive recursive rm. import { basename, parse, resolve } from 'path'; import { defaultTmp, defaultTmpSync } from './default-tmp.js'; import { ignoreENOENT, ignoreENOENTSync } from './ignore-enoent.js'; import { lstatSync, promises, renameSync, rmdirSync, unlinkSync } from './fs.js'; import { readdirOrError, readdirOrErrorSync } from './readdir-or-error.js'; import { fixEPERM, fixEPERMSync } from './fix-eperm.js'; import { errorCode } from './error.js'; const { lstat, rename, unlink, rmdir } = promises; // crypto.randomBytes is much slower, and Math.random() is enough here const uniqueFilename = (path) => `.${basename(path)}.${Math.random()}`; const unlinkFixEPERM = fixEPERM(unlink); const unlinkFixEPERMSync = fixEPERMSync(unlinkSync); export const rimrafMoveRemove = async (path, opt) => { opt?.signal?.throwIfAborted(); return ((await ignoreENOENT(lstat(path).then(stat => rimrafMoveRemoveDir(path, opt, stat)))) ?? true); }; const rimrafMoveRemoveDir = async (path, opt, ent) => { opt?.signal?.throwIfAborted(); if (!opt.tmp) { return rimrafMoveRemoveDir(path, { ...opt, tmp: await defaultTmp(path) }, ent); } if (path === opt.tmp && parse(path).root !== path) { throw new Error('cannot delete temp directory used for deletion'); } const entries = ent.isDirectory() ? await readdirOrError(path) : null; if (!Array.isArray(entries)) { // this can only happen if lstat/readdir lied, or if the dir was // swapped out with a file at just the right moment. /* c8 ignore start */ if (entries) { if (errorCode(entries) === 'ENOENT') { return true; } if (errorCode(entries) !== 'ENOTDIR') { throw entries; } } /* c8 ignore stop */ if (opt.filter && !(await opt.filter(path, ent))) { return false; } await ignoreENOENT(tmpUnlink(path, opt.tmp, unlinkFixEPERM)); return true; } const removedAll = (await Promise.all(entries.map(ent => rimrafMoveRemoveDir(resolve(path, ent.name), opt, ent)))).every(v => v === true); if (!removedAll) { return false; } // we don't ever ACTUALLY try to unlink /, because that can never work // but when preserveRoot is false, we could be operating on it. // No need to check if preserveRoot is not false. if (opt.preserveRoot === false && path === parse(path).root) { return false; } if (opt.filter && !(await opt.filter(path, ent))) { return false; } await ignoreENOENT(tmpUnlink(path, opt.tmp, rmdir)); return true; }; const tmpUnlink = async (path, tmp, rm) => { const tmpFile = resolve(tmp, uniqueFilename(path)); await rename(path, tmpFile); return await rm(tmpFile); }; export const rimrafMoveRemoveSync = (path, opt) => { opt?.signal?.throwIfAborted(); return (ignoreENOENTSync(() => rimrafMoveRemoveDirSync(path, opt, lstatSync(path))) ?? true); }; const rimrafMoveRemoveDirSync = (path, opt, ent) => { opt?.signal?.throwIfAborted(); if (!opt.tmp) { return rimrafMoveRemoveDirSync(path, { ...opt, tmp: defaultTmpSync(path) }, ent); } const tmp = opt.tmp; if (path === opt.tmp && parse(path).root !== path) { throw new Error('cannot delete temp directory used for deletion'); } const entries = ent.isDirectory() ? readdirOrErrorSync(path) : null; if (!Array.isArray(entries)) { // this can only happen if lstat/readdir lied, or if the dir was // swapped out with a file at just the right moment. /* c8 ignore start */ if (entries) { if (errorCode(entries) === 'ENOENT') { return true; } if (errorCode(entries) !== 'ENOTDIR') { throw entries; } } /* c8 ignore stop */ if (opt.filter && !opt.filter(path, ent)) { return false; } ignoreENOENTSync(() => tmpUnlinkSync(path, tmp, unlinkFixEPERMSync)); return true; } let removedAll = true; for (const ent of entries) { const p = resolve(path, ent.name); removedAll = rimrafMoveRemoveDirSync(p, opt, ent) && removedAll; } if (!removedAll) { return false; } if (opt.preserveRoot === false && path === parse(path).root) { return false; } if (opt.filter && !opt.filter(path, ent)) { return false; } ignoreENOENTSync(() => tmpUnlinkSync(path, tmp, rmdirSync)); return true; }; const tmpUnlinkSync = (path, tmp, rmSync) => { const tmpFile = resolve(tmp, uniqueFilename(path)); renameSync(path, tmpFile); return rmSync(tmpFile); }; //# sourceMappingURL=rimraf-move-remove.js.map