[DEP0147] DeprecationWarning: In future versions of Node.js, fs.rmdir(path, { recursive: true }) will be removed. Use fs.rm(path, { recursive: true }) instead
Ștergerea unui dosar cu tot conținutul prin fs.rmdir / fs.rmdirSync cu { recursive: true } e depreciată. Folosește fs.rmSync(cale, { recursive: true, force: true }) sau fs.promises.rm(...): face același lucru și, cu force: true, nu dă eroare dacă dosarul nu există.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Opțiunea recursive a fost adăugată la fs.rmdir în Node 12, ca soluție rapidă pentru ștergerea dosarelor cu conținut. Apoi a apărut fs.rm, gândit special pentru asta, iar rmdir a revenit la rolul inițial: ștergerea unui dosar gol. Din Node 16, combinația rmdir + recursive: true afișează [DEP0147], iar în versiunile viitoare opțiunea va dispărea.
Când va fi eliminată, același cod va da ENOTEMPTY: directory not empty pentru orice dosar cu fișiere, deci scripturile de curățare (dist, build, tmp) se vor opri. Merită schimbat acum.
fs.rm are două opțiuni importante: recursive: true (șterge și conținutul) și force: true (nu dă ENOENT dacă dosarul lipsește), exact comportamentul lui rm -rf.
De ce apare: cauzele frecvente
1Script de curățare a build-ului
fs.rmdirSync("dist", { recursive: true });fs.rmSync("dist", { recursive: true, force: true });fs.rmSync e funcția dedicată ștergerii recursive; force evită eroarea la prima rulare, când dist nu există.
2Varianta cu promisiuni
await fs.promises.rmdir("tmp", { recursive: true });await fs.promises.rm("tmp", { recursive: true, force: true });Aceeași înlocuire există și în fs/promises.
3Pachet de curățare învechit
// un pachet sau un script vechi din package.json
// apelează fs.rmdir cu recursive"scripts": {
"clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""
}Pentru o simplă ștergere de dosar nu mai ai nevoie de pachete ca rimraf; fs.rmSync face asta pe toate sistemele.
Repară eroarea, direct în pagină
Scriptul de build șterge dosarul vechi dist înainte să-l recreeze, dar folosește fs.rmdirSync cu recursive: true și primește [DEP0147] DeprecationWarning. Proiectul oprește programul la orice warning (primele rânduri). Șterge dosarul cu funcția recomandată, ca scriptul să afișeze dosarul nou, cu un singur fișier.
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
process.exitCode = 1;
});
const fs = require("fs");
console.log(`Fișiere vechi: ${fs.readdirSync("dist", { recursive: true }).length}`);
fs.rmdirSync("dist", { recursive: true });
fs.mkdirSync("dist");
fs.writeFileSync("dist/app.js", 'console.log("build nou");\n');
console.log(`Fișiere noi: ${fs.readdirSync("dist").join(", ")}`);Fișiere vechi: 4 Fișiere noi: app.js
Indiciu
fs.rmSync("dist", { recursive: true, force: true }).
Reparația
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
process.exitCode = 1;
});
const fs = require("fs");
console.log(`Fișiere vechi: ${fs.readdirSync("dist", { recursive: true }).length}`);
fs.rmSync("dist", { recursive: true, force: true });
fs.mkdirSync("dist");
fs.writeFileSync("dist/app.js", 'console.log("build nou");\n');
console.log(`Fișiere noi: ${fs.readdirSync("dist").join(", ")}`);De ce merge
fs.rmdir e destinat dosarelor goale, iar opțiunea recursive adăugată ulterior e depreciată și va dispărea. fs.rmSync cu recursive: true șterge dosarul cu tot conținutul (inclusiv subdosarul css), iar force: true face ca scriptul să meargă și la prima rulare, când dist nu există încă. Restul scriptului recreează dosarul cu fișierul nou.
Alte forme ale mesajului
(node:4120) [DEP0147] DeprecationWarning: In future versions of Node.js, fs.rmdir(path, { recursive: true }) will be removed. Use fs.rm(path, { recursive: true }) instead (Use `node --trace-deprecation ...` to show where the warning was created)DeprecationWarning: In future versions of Node.js, fs.rmdir(path, { recursive: true }) will be removed. Use fs.rm(path, { recursive: true }) insteadError: ENOTEMPTY: directory not empty, rmdir 'dist'
Cum o eviți pe viitor
- Folosește
fs.rmdirdoar pentru dosare goale, iar pentru ștergeri recursivefs.rm/fs.rmSync. - Adaugă
force: truecând e normal ca dosarul să lipsească (curățări, teste). - Verifică de două ori calea înainte de o ștergere recursivă: construiește-o din
__dirname, nu din date venite din afară.
Întrebări frecvente
E periculos fs.rmSync cu recursive?
Șterge definitiv, fără coș de gunoi, la fel ca rm -rf. O cale greșită (de exemplu goală sau /) poate șterge mult mai mult decât voiai, deci construiește calea cu grijă și nu o lua din input-ul utilizatorilor.
Ce face rmdir fără recursive pe un dosar cu fișiere?
Dă ENOTEMPTY: directory not empty. Asta va face și varianta cu recursive după ce opțiunea va fi eliminată.
Erori înrudite
Error: ENOTEMPTY: directory not empty, rmdir 'arhiva' Încerci să ștergi cu rmdir un dosar care mai conține fișiere. rmdir șterge doar dosare goale. Folosește fs.rmSync("arhiva", { recursive: true, force: true }) ca să ștergi dosarul cu tot conținutul. Error: ENOENT: no such file or directory, scandir 'rapoarte' Încerci să listezi cu readdir un dosar care nu există. scandir este operația de citire a unui dosar. Verifică numele și calea dosarului, iar dacă dosarul poate lipsi, creează-l înainte cu fs.mkdirSync(dosar, { recursive: true }). Error: EISDIR: illegal operation on a directory, read Ai dat o cale de dosar unei funcții care lucrează cu fișiere, de exemplu readFileSync("date") când date e un dosar. Listează dosarul cu readdirSync și citește fișierele din el, sau completează calea până la fișier. Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
