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

Error: ENOENT: no such file or directory, rename 'rapoarte/ianuarie.txt' -> 'arhiva/ianuarie.txt'

Pe scurt

Mutarea sau redenumirea a eșuat pentru că lipsește fie fișierul sursă, fie dosarul destinație. De obicei dosarul în care muți (arhiva) nu există încă. Creează-l înainte cu fs.mkdirSync("arhiva", { recursive: true }) și verifică ambele căi.

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

Ce înseamnă

fs.rename (și renameSync, fs.promises.rename) mută sau redenumește un fișier. Mesajul conține ambele căi: 'sursă' -> 'destinație'. ENOENT înseamnă că una din ele nu există, iar Node nu îți spune care, așa că le verifici pe amândouă:

  • sursa lipsește: nume greșit, fișierul a fost deja mutat la o rulare anterioară, cale relativă față de alt dosar decât crezi;
  • dosarul destinației lipsește: rename nu creează dosare, deci arhiva/ianuarie.txt eșuează dacă nu există dosarul arhiva.

A doua situație e cea mai frecventă: scripturi care arhivează sau sortează fișiere și rulează prima dată pe un calculator unde dosarul nu a fost creat. Obiectul erorii are path (sursa) și dest (destinația).

De ce apare: cauzele frecvente

1Dosarul destinație nu există

Greșit
JavaScript
fs.renameSync("rapoarte/ianuarie.txt", "arhiva/ianuarie.txt");
Corect
JavaScript
fs.mkdirSync("arhiva", { recursive: true });
fs.renameSync("rapoarte/ianuarie.txt", "arhiva/ianuarie.txt");

mkdirSync cu recursive: true creează dosarul (și părinții lui) și nu dă eroare dacă există deja.

2Fișierul sursă a fost deja mutat

Greșit
JavaScript
// rulat a doua oară
fs.renameSync("export.csv", "arhiva/export.csv");
Corect
JavaScript
if (fs.existsSync("export.csv")) {
  fs.renameSync("export.csv", "arhiva/export.csv");
}

Scripturile care rulează de mai multe ori trebuie să suporte situația în care treaba e deja făcută.

3Numele din readdir fără dosar

Greșit
JavaScript
for (const f of fs.readdirSync("rapoarte")) {
  fs.renameSync(f, path.join("arhiva", f));
}
Corect
JavaScript
for (const f of fs.readdirSync("rapoarte")) {
  fs.renameSync(path.join("rapoarte", f), path.join("arhiva", f));
}

readdirSync întoarce doar numele fișierelor, fără dosar; calea completă o construiești cu path.join.

Repară tu

Repară eroarea, direct în pagină

Scriptul mută toate rapoartele din dosarul rapoarte în dosarul arhiva, dar arhiva nu există încă și prima mutare dă Error: ENOENT: no such file or directory, rename 'rapoarte/februarie.txt' -> 'arhiva/februarie.txt'. Creează dosarul înainte de mutare, ca scriptul să afișeze ce a arhivat și câte rapoarte au rămas.

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

const rapoarte = fs.readdirSync("rapoarte").sort();

for (const fisier of rapoarte) {
  fs.renameSync(path.join("rapoarte", fisier), path.join("arhiva", fisier));
}

console.log(`Arhivate: ${fs.readdirSync("arhiva").sort().join(", ")}`);
console.log(`Rămase în rapoarte: ${fs.readdirSync("rapoarte").length}`);
După reparație, programul afișează
Arhivate: februarie.txt, ianuarie.txt
Rămase în rapoarte: 0
Indiciu

fs.mkdirSync("arhiva", { recursive: true }) înainte de buclă.

Alte forme ale mesajului

  • [Error: ENOENT: no such file or directory, rename 'export.csv' -> 'arhiva/export.csv'] { errno: -2, code: 'ENOENT', syscall: 'rename', path: 'export.csv', dest: 'arhiva/export.csv' }
  • Error: ENOENT: no such file or directory, copyfile 'sablon.html' -> 'dist/index.html'
  • Error: EXDEV: cross-device link not permitted, rename '/tmp/upload' -> '/app/uploads/poza.jpg'

Cum o eviți pe viitor

  • Creează dosarele de destinație la începutul scriptului cu mkdirSync(dosar, { recursive: true }).
  • Construiește căile din readdirSync cu path.join(dosar, nume).
  • Fă scripturile de mutare sigure la rulări repetate: verifică sursa sau tratează err.code === "ENOENT".
  • Când depanezi, afișează ambele căi cu path.resolve, ca să vezi unde caută Node.

Întrebări frecvente

Cum aflu care dintre cele două căi lipsește?

Verifică-le separat: fs.existsSync(sursa) și fs.existsSync(path.dirname(destinatie)). Mesajul le arată pe amândouă, dar nu spune care e problema.

Ce e EXDEV la rename?

Sursa și destinația sunt pe discuri (partiții) diferite, de exemplu /tmp și dosarul proiectului, iar rename nu poate muta între ele. Copiază cu fs.copyFileSync și apoi șterge sursa cu fs.unlinkSync.

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.