TypeError: fs.readFileSync is not a function
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
const fs = require("fs/promises");
const text = fs.readFileSync("note.txt", "utf8");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ă
import fs from "fs/promises";
fs.writeFileSync("a.txt", "x");import fs from "fs";
fs.writeFileSync("a.txt", "x");Funcțiile Sync sunt doar în modulul fs.
3Cod de Node rulat în browser
// în React / pagina web
import fs from "fs";
fs.readFileSync("date.json");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ă 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.
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`);
}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.
Reparația
const fs = require("fs/promises");
async function main() {
for (const fisier of ["magazin1.json", "magazin2.json"]) {
const produse = JSON.parse(await fs.readFile(fisier, "utf8"));
console.log(`${fisier}: ${produse.length} produse`);
}
}
main();De ce merge
fs/promises conține doar funcții care întorc promisiuni, deci readFileSync nu există acolo și valoarea lui e undefined. fs.readFile din fs/promises întoarce o promisiune cu textul fișierului, pe care o aștepți cu await. Pentru că folosești await, bucla stă într-o funcție async main(); fișierele se citesc pe rând, iar fiecare await așteaptă citirea înainte de afișare.
Alte forme ale mesajului
TypeError: fs.writeFileSync is not a functionTypeError: fs.existsSync is not a functionTypeError: fs.readFile is not a function
Cum o eviți pe viitor
- Alege un stil per fișier:
fscu funcțiiSyncpentru scripturi simple,fs/promisescuawaitpentru 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
TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received undefined Ai apelat o funcție asincronă din fs (readFile, writeFile, readdir...) fără callback, ca și cum ar întoarce direct rezultatul. Ori dai un callback (err, date) => {...}, ori folosești varianta Sync, ori fs/promises cu await. Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "Stoc insuficient". O promisiune a fost respinsă și nimeni nu a tratat eroarea: lipsește try/catch în jurul lui await sau .catch() la final. Din Node 15, o respingere netratată oprește programul. Adaugă try/catch (sau .catch) și respinge cu new Error(...), nu cu un text. Î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.
