...
Eroare Node.js · Fișiere și căi: fs și path

Error: ENOENT: no such file or directory, unlink 'temp/export-2.csv'

Pe scurt

Încerci să ștergi un fișier care nu există (a fost deja șters sau calea e greșită). Dacă vrei doar ca fișierul să nu mai existe, folosește fs.rmSync(cale, { force: true }), care nu dă eroare când fișierul lipsește.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

unlink este operația de ștergere a unui fișier (fs.unlinkSync, fs.unlink, fs.promises.unlink). ENOENT înseamnă că la calea dată nu există nimic de șters.

De cele mai multe ori nu e o problemă reală: vrei să cureți fișiere temporare, iar unele au fost deja șterse de o rulare anterioară, de alt proces sau nici nu au fost create. Pentru curățenie, rezultatul dorit („fișierul nu mai există”) e deja atins, dar unlinkSync aruncă totuși eroarea.

Alteori calea e greșită: lipsește dosarul din cale, extensia e alta sau calea relativă pornește din alt dosar. Mesajul arată exact calea primită. Aceeași idee la fs.rmSync fără force: mesajul spune lstat în loc de unlink.

De ce apare: cauzele frecvente

1Fișierul a fost deja șters

Greșit
JavaScript
for (const f of temporare) fs.unlinkSync(f);
Corect
JavaScript
for (const f of temporare) fs.rmSync(f, { force: true });

Cu force: true, rmSync ignoră fișierele care lipsesc, deci curățenia poate rula de oricâte ori.

2Tratezi doar lipsa fișierului

Greșit
JavaScript
await fs.promises.unlink("sesiune.json");
Corect
JavaScript
try {
  await fs.promises.unlink("sesiune.json");
} catch (err) {
  if (err.code !== "ENOENT") throw err;
}

Ignori doar ENOENT; alte erori (permisiuni, fișier blocat) rămân vizibile.

3Cale fără dosar

Greșit
JavaScript
// fișierul este în uploads/
fs.unlinkSync("avatar-17.png");
Corect
JavaScript
fs.unlinkSync(path.join("uploads", "avatar-17.png"));

Calea trebuie să ducă exact la fișier, pornind din dosarul curent al procesului.

Repară tu

Repară eroarea, direct în pagină

Scriptul de curățenie șterge exporturile temporare din lista de mai jos, dar unul a fost deja șters la o rulare anterioară, așa că unlinkSync se oprește cu Error: ENOENT: no such file or directory, unlink 'temp/export-2.csv'. Șterge fișierele într-un fel care nu dă eroare când fișierul lipsește deja, ca scriptul să afișeze ce a rămas în temp.

Codul care dă eroarea
JavaScript
const fs = require("fs");

const temporare = ["temp/export-1.csv", "temp/export-2.csv", "temp/export-3.csv"];

for (const fisier of temporare) {
  fs.unlinkSync(fisier);
}

console.log(`Șterse: ${temporare.length}`);
console.log(`Rămase în temp: ${fs.readdirSync("temp").join(", ")}`);
După reparație, programul afișează
Șterse: 3
Rămase în temp: pastreaza.txt
Indiciu

fs.rmSync(cale, { force: true }) nu dă eroare dacă fișierul nu există.

Alte forme ale mesajului

  • Error: ENOENT: no such file or directory, lstat 'temp/export-2.csv'
  • [Error: ENOENT: no such file or directory, unlink 'sesiune.json'] { errno: -2, code: 'ENOENT', syscall: 'unlink', path: 'sesiune.json' }
  • Error: ENOENT: no such file or directory, access 'temp/export-2.csv'

Cum o eviți pe viitor

  • Pentru curățenie folosește fs.rmSync(cale, { force: true }) sau fs.promises.rm(cale, { force: true }).
  • Pentru dosare întregi: fs.rmSync(dosar, { recursive: true, force: true }).
  • Dacă folosești unlink, prinde doar ENOENT și aruncă mai departe celelalte erori.
  • Nu verifica cu existsSync înainte de ștergere: între verificare și ștergere fișierul poate dispărea.

Întrebări frecvente

De ce în mesaj scrie lstat, nu unlink?

Așa arată eroarea de la fs.rmSync fără force: înainte de ștergere, Node verifică ce tip de intrare e la cale (cu lstat), iar verificarea eșuează prima.

Pot șterge un dosar cu unlink?

Nu. Pentru dosare folosește fs.rmSync(dosar, { recursive: true }); unlink pe un dosar dă EISDIR sau EPERM.

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.