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

TypeError: fs.readFileSync is not a function

Pe scurt

Ai importat varianta cu promisiuni a modulului (require("fs/promises") sau fs.promises), care are doar funcții asincrone, fără Sync. Folosește await fs.readFile(...) din fs/promises, sau importă modulul obișnuit "fs" dacă vrei readFileSync.

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

Ce înseamnă

Node are două feluri de a importa funcțiile pentru fișiere: modulul fs (cu funcții cu callback și cu variantele sincrone readFileSync, writeFileSync) și modulul fs/promises (doar funcții care întorc promisiuni: readFile, writeFile, readdir). În fs/promises nu există nicio funcție cu Sync în nume, așa că fs.readFileSync este undefined.

Eroarea apare când copiezi const fs = require("fs/promises") dintr-un exemplu modern și apoi scrii codul în stilul sincron, sau invers, când folosești await fs.readFile cu modulul obișnuit. Același mesaj îl primești și în browser sau când fs a fost înlocuit de un bundler (de exemplu în codul de frontend).

De ce apare: cauzele frecvente

1fs/promises folosit cu funcții Sync

Greșit
JavaScript
const fs = require("fs/promises");
const text = fs.readFileSync("note.txt", "utf8");
Corect
JavaScript
const fs = require("fs/promises");
const text = await fs.readFile("note.txt", "utf8");

În fs/promises funcția se numește readFile și întoarce o promisiune, pe care o aștepți cu await.

2Vrei varianta sincronă

Greșit
JavaScript
import fs from "fs/promises";
fs.writeFileSync("a.txt", "x");
Corect
JavaScript
import fs from "fs";
fs.writeFileSync("a.txt", "x");

Funcțiile Sync sunt doar în modulul fs.

3Cod de Node rulat în browser

Greșit
JavaScript
// în React / pagina web
import fs from "fs";
fs.readFileSync("date.json");
Corect
JavaScript
const r = await fetch("/date.json");
const date = await r.json();

Browserul nu are acces la fișierele de pe disc; datele se cer de la server.

Repară tu

Repară eroarea, direct în pagină

Programul importă fs/promises, dar folosește readFileSync și dă TypeError: fs.readFileSync is not a function. Păstrează importul din fs/promises și citește cele două fișiere cu varianta asincronă, ca programul să afișeze numărul de produse din fiecare.

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

for (const fisier of ["magazin1.json", "magazin2.json"]) {
  const produse = JSON.parse(fs.readFileSync(fisier, "utf8"));
  console.log(`${fisier}: ${produse.length} produse`);
}
După reparație, programul afișează
magazin1.json: 3 produse
magazin2.json: 2 produse
Indiciu

În fs/promises funcția se numește readFile și se folosește cu await într-o funcție async.

Alte forme ale mesajului

  • TypeError: fs.writeFileSync is not a function
  • TypeError: fs.existsSync is not a function
  • TypeError: fs.readFile is not a function

Cum o eviți pe viitor

  • Alege un stil per fișier: fs cu funcții Sync pentru scripturi simple, fs/promises cu await pentru servere și cod asincron.
  • Numește clar importul: const fsp = require("fs/promises"), ca să vezi imediat ce variantă folosești.
  • Nu folosi fs în cod care rulează în browser.

Întrebări frecvente

Când e mai bine să folosesc readFileSync?

În scripturi mici sau la pornirea aplicației (de exemplu citirea configurării). Într-un server care răspunde la cereri, preferă varianta asincronă, ca să nu blochezi celelalte cereri cât timp se citește fișierul.

Pot folosi existsSync cu fs/promises?

Nu există în fs/promises. Fie imporți și fs pentru existsSync, fie folosești await fsp.access(cale) într-un try/catch.

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.