...
Eroare Node.js · Versiuni Node: API-uri depreciate și eliminate

[DEP0147] DeprecationWarning: In future versions of Node.js, fs.rmdir(path, { recursive: true }) will be removed. Use fs.rm(path, { recursive: true }) instead

Pe scurt

Ș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

Greșit
JavaScript
fs.rmdirSync("dist", { recursive: true });
Corect
JavaScript
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

Greșit
JavaScript
await fs.promises.rmdir("tmp", { recursive: true });
Corect
JavaScript
await fs.promises.rm("tmp", { recursive: true, force: true });

Aceeași înlocuire există și în fs/promises.

3Pachet de curățare învechit

Greșit
JavaScript
// un pachet sau un script vechi din package.json
// apelează fs.rmdir cu recursive
Corect
JavaScript
"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ă tu

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.

Codul care dă eroarea
JavaScript
// 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(", ")}`);
După reparație, programul afișează
Fișiere vechi: 4
Fișiere noi: app.js
Indiciu

fs.rmSync("dist", { recursive: true, force: true }).

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 }) instead
  • Error: ENOTEMPTY: directory not empty, rmdir 'dist'

Cum o eviți pe viitor

  • Folosește fs.rmdir doar pentru dosare goale, iar pentru ștergeri recursive fs.rm / fs.rmSync.
  • Adaugă force: true câ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

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.