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

Error: ENOTDIR: not a directory, scandir 'proiect/README.md'

Pe scurt

Ai cerut conținutul unui dosar (readdir), dar la calea dată e un fișier. Se întâmplă de obicei la parcurgerea recursivă a dosarelor, când intri și în fișiere. Verifică întâi cu fs.statSync(cale).isDirectory() sau folosește readdirSync cu { withFileTypes: true }.

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

Ce înseamnă

ENOTDIR (Error NOT a DIRectory): operația are nevoie de un dosar, dar la calea dată (sau pe drumul spre ea) e un fișier. scandir este operația din spatele lui fs.readdirSync / fs.readdir, care listează un dosar.

Cel mai des apare într-o funcție recursivă care parcurge un proiect: listezi un dosar, iar pentru fiecare nume apelezi din nou funcția, fără să verifici dacă e dosar. La primul fișier (README.md), readdirSync eșuează.

Aceeași eroare cu alt cuvânt după virgulă (open, mkdir, stat) apare când o parte din mijlocul căii e fișier: config.json/setari.txt sau mkdirSync("raport.txt/iunie"). Calea din mesaj îți arată locul exact.

De ce apare: cauzele frecvente

1Recursivitate fără verificarea tipului

Greșit
JavaScript
function listeaza(dosar) {
  for (const nume of fs.readdirSync(dosar)) {
    console.log(nume);
    listeaza(path.join(dosar, nume));
  }
}
Corect
JavaScript
function listeaza(dosar) {
  for (const intrare of fs.readdirSync(dosar, { withFileTypes: true })) {
    console.log(intrare.name);
    if (intrare.isDirectory()) listeaza(path.join(dosar, intrare.name));
  }
}

withFileTypes: true îți dă pentru fiecare intrare și tipul, deci intri recursiv doar în dosare.

2Primești un fișier unde te așteptai la dosar

Greșit
JavaScript
// node index.js poze.zip
const fisiere = fs.readdirSync(process.argv[2]);
Corect
JavaScript
const cale = process.argv[2];
if (!fs.statSync(cale).isDirectory()) {
  console.log(`${cale} nu este un dosar`);
  process.exit(1);
}
const fisiere = fs.readdirSync(cale);

Când calea vine de la utilizator, verifici tipul și dai un mesaj clar.

3Un fișier în mijlocul căii

Greșit
JavaScript
// raport.txt este fișier
fs.writeFileSync("raport.txt/iunie.txt", "...");
Corect
JavaScript
fs.mkdirSync("rapoarte", { recursive: true });
fs.writeFileSync("rapoarte/iunie.txt", "...");

Nu poți pune fișiere „într-un fișier”. Fiecare bucată din cale, în afară de ultima, trebuie să fie dosar.

Repară tu

Repară eroarea, direct în pagină

Funcția arbore afișează structura dosarului proiect, dar intră recursiv și în fișiere, așa că se oprește cu Error: ENOTDIR: not a directory, scandir 'proiect/README.md'. Fă-o să intre recursiv doar în dosare, ca programul să afișeze tot arborele.

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

function arbore(dosar, nivel = 0) {
  const nume = fs.readdirSync(dosar).sort();
  for (const n of nume) {
    console.log(`${"  ".repeat(nivel)}${n}`);
    arbore(path.join(dosar, n), nivel + 1);
  }
}

arbore("proiect");
După reparație, programul afișează
README.md
src
  index.js
  utils
    preturi.js
Indiciu

Citește intrările cu { withFileTypes: true } și apelează arbore doar când intrare.isDirectory() e adevărat.

Alte forme ale mesajului

  • Error: ENOTDIR: not a directory, open 'config.json/setari.txt'
  • Error: ENOTDIR: not a directory, mkdir 'raport.txt/iunie'
  • Error: ENOTDIR: not a directory, rmdir 'note.txt'
  • [Error: ENOTDIR: not a directory, scandir 'proiect/README.md'] { errno: -20, code: 'ENOTDIR', syscall: 'scandir', path: 'proiect/README.md' }

Cum o eviți pe viitor

  • La parcurgerea dosarelor folosește readdirSync(dosar, { withFileTypes: true }) și intrare.isDirectory().
  • Pentru o listă completă a fișierelor dintr-un arbore, fs.readdirSync(dosar, { recursive: true }) (Node 20+) face recursivitatea pentru tine.
  • Verifică tipul căilor primite de la utilizator cu fs.statSync(cale).isDirectory().
  • Folosește nume diferite pentru fișiere și dosare (nu raport și raport/).

Întrebări frecvente

Care e diferența față de EISDIR?

Sunt opuse: ENOTDIR apare când operația cere un dosar și găsește un fișier, iar EISDIR când cere un fișier (de exemplu readFileSync) și găsește un dosar.

isDirectory sau isDirectory()?

Este o metodă, deci cu paranteze: intrare.isDirectory(). Fără paranteze, valoarea e funcția însăși, care e mereu „adevărată” într-un if.

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.