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

Error: ENOENT: no such file or directory, scandir 'rapoarte'

Pe scurt

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

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

Ce înseamnă

E aceeași eroare ENOENT (nu există nimic la calea dată), dar operația care a eșuat este scandir, adică citirea conținutului unui dosar cu fs.readdirSync, fs.readdir sau fs.promises.readdir. Calea din ghilimele e dosarul căutat.

Apare când numele dosarului e greșit, când rulezi programul din alt dosar decât crezi (calea relativă pornește din process.cwd()), sau când programul se bazează pe un dosar care se creează abia mai târziu: uploads, rapoarte, logs. Pe un calculator nou, după git clone, dosarele goale nu există, pentru că Git nu păstrează dosare goale.

Pe Linux contează și literele mari: Poze și poze sunt dosare diferite.

De ce apare: cauzele frecvente

1Dosarul se creează abia mai târziu

Greșit
JavaScript
const fisiere = fs.readdirSync("rapoarte");
Corect
JavaScript
fs.mkdirSync("rapoarte", { recursive: true });
const fisiere = fs.readdirSync("rapoarte");

mkdirSync cu recursive: true creează dosarul dacă lipsește și nu face nimic dacă există.

2Numele sau calea dosarului e greșită

Greșit
JavaScript
fs.readdirSync("poze"); // dosarul real: public/poze
Corect
JavaScript
fs.readdirSync("public/poze");

Calea trebuie să ajungă exact la dosar, pornind din dosarul curent.

3Calea depinde de dosarul de pornire

Greșit
JavaScript
fs.readdirSync("date");
Corect
JavaScript
fs.readdirSync(path.join(__dirname, "date"));

Cu __dirname calea pornește din dosarul scriptului, nu din dosarul terminalului.

Repară tu

Repară eroarea, direct în pagină

Programul salvează rapoarte în dosarul rapoarte, apoi le listează. La prima rulare dosarul nu există, iar listarea de la început dă Error: ENOENT: no such file or directory, scandir 'rapoarte'. Creează dosarul dacă lipsește, înainte de prima operație, ca programul să afișeze rapoartele existente înainte și după salvare.

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

console.log(`Rapoarte existente: ${fs.readdirSync("rapoarte").length}`);

for (const luna of ["iunie", "iulie"]) {
  fs.writeFileSync(path.join("rapoarte", `${luna}.txt`), `Raport ${luna}`);
}

console.log(fs.readdirSync("rapoarte").join(", "));
După reparație, programul afișează
Rapoarte existente: 0
iulie.txt, iunie.txt
Indiciu

fs.mkdirSync("rapoarte", { recursive: true }) nu dă eroare nici dacă dosarul există deja.

Alte forme ale mesajului

  • Error: ENOENT: no such file or directory, scandir '/app/uploads'
  • [Error: ENOENT: no such file or directory, scandir 'poze'] { errno: -2, code: 'ENOENT', syscall: 'scandir', path: 'poze' }
  • Error: ENOENT: no such file or directory, mkdir 'a/b/c'

Cum o eviți pe viitor

  • Creează la pornire dosarele de care are nevoie aplicația, cu { recursive: true }.
  • Pune un fișier .gitkeep în dosarele goale care trebuie să existe în repository.
  • Construiește căile din __dirname, nu din dosarul curent.
  • Verifică literele mari și mici în numele dosarelor.

Întrebări frecvente

Ce înseamnă scandir?

Este numele apelului de sistem care citește lista de fișiere dintr-un dosar. Îl folosesc readdir și readdirSync.

Ce e varianta cu mkdir 'a/b/c'?

mkdirSync("a/b/c") fără recursive: true cere ca a/b să existe deja. Cu recursive: true Node creează toate dosarele din cale.

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.