[DEP0176] DeprecationWarning: fs.F_OK is deprecated, use fs.constants.F_OK instead
Constantele fs.F_OK, fs.R_OK, fs.W_OK și fs.X_OK, folosite cu fs.access, sunt depreciate la rulare din Node 24. Scrie fs.constants.F_OK (și restul la fel); valorile sunt aceleași, doar locul s-a schimbat.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fs.access(cale, mod) verifică dacă un fișier există (F_OK) sau dacă poți să-l citești (R_OK), să scrii în el (W_OK) ori să-l execuți (X_OK). Constantele există de mult în fs.constants, dar Node le păstra și direct pe fs pentru codul vechi.
Din Node 24, accesarea lui fs.F_OK, fs.R_OK, fs.W_OK sau fs.X_OK emite DEP0176. Programul merge mai departe, dar în versiunile viitoare aceste proprietăți vor dispărea și vor deveni undefined.
Avertismentul apare o singură dată, la prima accesare. Dacă vine dintr-un pachet, node --trace-deprecation îți arată fișierul. Același lucru e valabil și pentru fs/promises: constantele se iau din fs.constants (sau fsPromises.constants).
De ce apare: cauzele frecvente
1Verificarea existenței unui fișier
fs.accessSync("config.json", fs.F_OK);fs.accessSync("config.json", fs.constants.F_OK);Aceeași constantă (valoarea 0), luată din locul recomandat.
2Mai multe drepturi combinate
fs.accessSync(cale, fs.R_OK | fs.W_OK);const { R_OK, W_OK } = fs.constants;
fs.accessSync(cale, R_OK | W_OK);Destructurarea din fs.constants păstrează codul scurt și elimină avertismentul.
3Cod cu promisiuni
await fs.promises.access(cale, fs.W_OK);await fs.promises.access(cale, fs.constants.W_OK);Și varianta cu promisiuni primește constantele din fs.constants.
Repară eroarea, direct în pagină
Funcția poateScrie verifică dacă se poate scrie în fișierele de log, folosind fs.F_OK și fs.W_OK, iar Node 24 afișează [DEP0176] DeprecationWarning. Proiectul oprește programul la orice warning (primele rânduri). Ia constantele din locul recomandat, ca programul să afișeze rezultatul pentru cele două fișiere.
// 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");
function poateScrie(cale) {
try {
fs.accessSync(cale, fs.F_OK | fs.W_OK);
return true;
} catch {
return false;
}
}
console.log(`app.log: ${poateScrie("app.log")}`);
console.log(`lipsa.log: ${poateScrie("lipsa.log")}`);app.log: true lipsa.log: false
Indiciu
Folosește fs.constants.F_OK și fs.constants.W_OK.
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");
function poateScrie(cale) {
try {
fs.accessSync(cale, fs.constants.F_OK | fs.constants.W_OK);
return true;
} catch {
return false;
}
}
console.log(`app.log: ${poateScrie("app.log")}`);
console.log(`lipsa.log: ${poateScrie("lipsa.log")}`);De ce merge
Din Node 24, citirea lui fs.F_OK sau fs.W_OK emite DEP0176, pentru că aceste constante vor fi scoase de pe obiectul fs. Valorile sunt aceleași în fs.constants, deci accessSync se comportă identic: app.log există și poate fi scris, iar lipsa.log lipsește și ajunge în catch.
Alte forme ale mesajului
(node:4120) [DEP0176] DeprecationWarning: fs.F_OK is deprecated, use fs.constants.F_OK instead (Use `node --trace-deprecation ...` to show where the warning was created)[DEP0176] DeprecationWarning: fs.R_OK is deprecated, use fs.constants.R_OK instead[DEP0176] DeprecationWarning: fs.W_OK is deprecated, use fs.constants.W_OK instead[DEP0176] DeprecationWarning: fs.X_OK is deprecated, use fs.constants.X_OK instead
Cum o eviți pe viitor
- Caută în proiect
fs.F_OK,fs.R_OK,fs.W_OK,fs.X_OKși înlocuiește-le cufs.constants.*. - Pentru simpla verificare a existenței,
fs.existsSync(cale)e mai scurt. - Rulează testele cu
node --throw-deprecationîn CI, ca să afli imediat de API-urile depreciate.
Întrebări frecvente
E nevoie de fs.access ca să verific dacă există un fișier?
Nu neapărat. fs.existsSync(cale) e suficient pentru o verificare simplă. Dacă urmează să deschizi fișierul, e și mai bine să-l deschizi direct și să tratezi ENOENT, ca să nu existe o fereastră în care fișierul dispare între verificare și deschidere.
De ce n-am văzut avertismentul în Node 20 sau 22?
Acolo deprecierea era doar în documentație. În Node 24 a devenit depreciere la rulare, adică afișată în consolă.
Erori înrudite
[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ă. Error: EACCES: permission denied, open 'raport.txt' Sistemul de operare nu-i dă procesului Node voie să deschidă fișierul (de obicei pentru scriere): fișierul e doar-citire, aparține altui utilizator (creat cu sudo) sau e într-un dosar protejat. Repară drepturile (chmod / chown) sau scrie într-un dosar al tău; nu rula aplicația cu sudo. Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. Î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.
