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

TypeError: The "fd" argument must be of type number. Received type string ('raport.txt')

Pe scurt

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

Greșit
JavaScript
fs.writeSync("raport.txt", "Comenzi: 14\n");
Corect
JavaScript
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

Greșit
JavaScript
fs.writeSync("raport.txt", text);
Corect
JavaScript
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

Greșit
JavaScript
const fh = await fs.promises.open("log.txt", "a");
fs.writeSync(fh, "linie\n");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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());
După reparație, programul afișează
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.

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 undefined
  • TypeError [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-un finally.
  • Nu amesteca API-ul sincron (fs.writeSync) cu obiectele FileHandle din fs/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

← 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.