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

[DEP0176] DeprecationWarning: fs.F_OK is deprecated, use fs.constants.F_OK instead

Pe scurt

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

Greșit
JavaScript
fs.accessSync("config.json", fs.F_OK);
Corect
JavaScript
fs.accessSync("config.json", fs.constants.F_OK);

Aceeași constantă (valoarea 0), luată din locul recomandat.

2Mai multe drepturi combinate

Greșit
JavaScript
fs.accessSync(cale, fs.R_OK | fs.W_OK);
Corect
JavaScript
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

Greșit
JavaScript
await fs.promises.access(cale, fs.W_OK);
Corect
JavaScript
await fs.promises.access(cale, fs.constants.W_OK);

Și varianta cu promisiuni primește constantele din fs.constants.

Repară tu

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.

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");

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")}`);
După reparație, programul afișează
app.log: true
lipsa.log: false
Indiciu

Folosește fs.constants.F_OK și fs.constants.W_OK.

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 cu fs.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

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