TypeError: The "fd" argument must be of type number. Received type string ('raport.txt')
Funcțiile fs.writeSync, fs.readSync, fs.closeSync și fs.fstatSync lucrează cu un descriptor de fișier (un număr), nu cu numele fișierului. Deschide întâi fișierul cu const fd = fs.openSync(nume, "w"), lucrează cu fd, apoi închide-l cu fs.closeSync(fd). Sau folosește fs.writeFileSync / fs.appendFileSync, care primesc direct numele.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În fs există două familii de funcții. Unele primesc calea fișierului și se ocupă singure de deschidere și închidere: readFileSync, writeFileSync, appendFileSync. Altele lucrează la nivel mai jos, cu un descriptor de fișier (fd): un număr întreg primit de la fs.openSync. Din a doua familie fac parte writeSync, readSync, closeSync, fstatSync, ftruncateSync.
Mesajul spune că ai dat unei funcții din a doua familie un text (de obicei numele fișierului) sau undefined (un fd pierdut, o variabilă greșită). Valoarea primită apare la final: Received type string ('raport.txt').
În Node 24 mesajul apare fără codul [ERR_INVALID_ARG_TYPE] în primul rând, dar codul e tot ERR_INVALID_ARG_TYPE (îl vezi în code: sub mesaj). În versiunile mai vechi apare direct TypeError [ERR_INVALID_ARG_TYPE]: The "fd" argument....
De ce apare: cauzele frecvente
1Numele fișierului în loc de descriptor
fs.writeSync("raport.txt", "Comenzi: 14\n");const fd = fs.openSync("raport.txt", "w");
fs.writeSync(fd, "Comenzi: 14\n");
fs.closeSync(fd);openSync deschide fișierul și îți dă numărul cu care îl folosești mai departe.
2Ai nevoie doar să scrii tot textul
fs.writeSync("raport.txt", text);fs.writeFileSync("raport.txt", text);Pentru scrieri simple nu ai nevoie de descriptor: writeFileSync deschide, scrie și închide într-un singur apel.
3FileHandle din fs/promises dat unei funcții sincrone
const fh = await fs.promises.open("log.txt", "a");
fs.writeSync(fh, "linie\n");const fh = await fs.promises.open("log.txt", "a");
await fh.write("linie\n");
await fh.close();fs.promises.open întoarce un obiect FileHandle, cu metode proprii. Numărul ar fi fh.fd, dar nu amesteca cele două API-uri.
Repară eroarea, direct în pagină
Programul scrie un raport linie cu linie cu fs.writeSync și dă TypeError: The "fd" argument must be of type number. Received type string ('raport.txt'). Deschide fișierul o dată cu fs.openSync, scrie liniile prin descriptor și închide-l la final, ca programul să afișeze raportul.
const fs = require("fs");
const linii = ["Raport zilnic", "Comenzi: 14", "Încasări: 2350 lei"];
for (const linie of linii) {
fs.writeSync("raport.txt", linie + "\n");
}
console.log(fs.readFileSync("raport.txt", "utf8").trim());Raport zilnic Comenzi: 14 Încasări: 2350 lei
Indiciu
const fd = fs.openSync("raport.txt", "w"); înainte de buclă și fs.closeSync(fd); după ea.
Reparația
const fs = require("fs");
const linii = ["Raport zilnic", "Comenzi: 14", "Încasări: 2350 lei"];
const fd = fs.openSync("raport.txt", "w");
for (const linie of linii) {
fs.writeSync(fd, linie + "\n");
}
fs.closeSync(fd);
console.log(fs.readFileSync("raport.txt", "utf8").trim());De ce merge
fs.writeSync nu știe să deschidă fișiere după nume: primește descriptorul unui fișier deja deschis. fs.openSync("raport.txt", "w") creează (sau golește) fișierul și întoarce acel număr, iar scrierile din buclă îl folosesc pe rând. fs.closeSync(fd) eliberează descriptorul la final; fără el, fișierul rămâne deschis până se oprește procesul.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "fd" argument must be of type number. Received type string ('raport.txt')TypeError [ERR_INVALID_ARG_TYPE]: The "fd" argument must be of type number. Received undefinedTypeError [ERR_INVALID_ARG_TYPE]: The "fd" argument must be of type number. Received an instance of FileHandle
Cum o eviți pe viitor
- Pentru citiri și scrieri complete folosește
readFileSync,writeFileSync,appendFileSync: primesc calea. - Când ai nevoie de descriptor (multe scrieri mici în același fișier), ține-l într-o variabilă cu nume clar (
fd) și închide-l într-unfinally. - Nu amesteca API-ul sincron (
fs.writeSync) cu obiecteleFileHandledinfs/promises.
Întrebări frecvente
Ce este un descriptor de fișier?
Un număr mic pe care sistemul de operare îl dă fiecărui fișier deschis de proces. Prin el, citirile și scrierile ulterioare știu despre ce fișier e vorba, fără să-l mai caute după nume.
De ce aș folosi openSync și writeSync?
Când scrii de multe ori în același fișier (de exemplu mii de linii), e mai eficient să-l deschizi o dată decât să-l redeschizi la fiecare appendFileSync. Pentru volume mari, un createWriteStream e de obicei și mai potrivit.
Erori înrudite
Error: EBADF: bad file descriptor, write Încerci să scrii (sau să citești) printr-un descriptor de fișier care a fost deja închis. De obicei fs.closeSync(fd) e pus în buclă sau înainte de ultima scriere. Închide fișierul o singură dată, după ce ai terminat toate operațiile, ideal într-un finally. TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined Ai dat unei funcții din fs sau path o cale care este undefined, nu un text. De obicei vine din process.argv[2] lipsă, o proprietate scrisă greșit sau o variabilă de mediu nesetată. Verifică variabila și pune o valoare implicită. TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'append' Ai dat o valoare greșită pentru modul de deschidere a fișierului (flag). Node acceptă doar coduri scurte: "r" citire, "w" scriere de la zero, "a" adăugare la final, "wx" scriere doar dacă fișierul nu există. Pentru adăugare scrie { flag: "a" } sau folosește fs.appendFileSync. Î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.
