TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Object
Încerci să scrii în fișier un obiect sau un tablou direct, dar writeFileSync și appendFileSync acceptă doar text sau Buffer. Transformă datele în text: JSON.stringify(date, null, 2) pentru JSON, sau String(numar) pentru numere.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
writeFileSync, writeFile, appendFileSync și fs.promises.writeFile scriu în fișier octeți: primesc un text (string) sau date binare (Buffer, TypedArray, DataView). Un obiect JavaScript nu are o formă de text implicită pentru fișier, așa că Node refuză și îți spune ce a primit: Received an instance of Object (sau Array, sau type number (42)).
Cea mai des întâlnită situație: vrei să salvezi date ca JSON și treci obiectul direct, uitând de JSON.stringify. La citire faci invers: JSON.parse(fs.readFileSync(f, "utf8")). Linia din stivă care pornește din fișierul tău îți arată apelul fs cu problema.
De ce apare: cauzele frecvente
1Obiect salvat fără JSON.stringify
fs.writeFileSync("contacte.json", contacte);fs.writeFileSync("contacte.json", JSON.stringify(contacte, null, 2));JSON.stringify transformă obiectul în text JSON, pe care fs îl poate scrie.
2Număr scris direct
fs.writeFileSync("contor.txt", 42);fs.writeFileSync("contor.txt", String(42));Și numerele trebuie transformate în text înainte de scriere.
3Promisiunea în loc de date
const date = obtineDate(); // funcție async
fs.writeFileSync("date.json", date);const date = await obtineDate();
fs.writeFileSync("date.json", JSON.stringify(date));Fără await ai o promisiune (Received an instance of Promise), nu datele.
Repară eroarea, direct în pagină
Programul salvează lista de contacte în contacte.json, dar dă TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string... Received an instance of Array. Transformă lista în text JSON formatat înainte de scriere, ca programul să citească fișierul înapoi și să afișeze contactele.
const fs = require("fs");
const contacte = [
{ nume: "Ana Pop", telefon: "0722000111" },
{ nume: "Mihai Ionescu", telefon: "0733000222" },
];
fs.writeFileSync("contacte.json", contacte);
const citite = JSON.parse(fs.readFileSync("contacte.json", "utf8"));
for (const c of citite) console.log(`${c.nume}: ${c.telefon}`);Ana Pop: 0722000111 Mihai Ionescu: 0733000222
Indiciu
JSON.stringify(lista, null, 2) transformă tabloul în text JSON cu indentare de 2 spații.
Reparația
const fs = require("fs");
const contacte = [
{ nume: "Ana Pop", telefon: "0722000111" },
{ nume: "Mihai Ionescu", telefon: "0733000222" },
];
fs.writeFileSync("contacte.json", JSON.stringify(contacte, null, 2));
const citite = JSON.parse(fs.readFileSync("contacte.json", "utf8"));
for (const c of citite) console.log(`${c.nume}: ${c.telefon}`);De ce merge
Un fișier conține octeți, iar writeFileSync știe să scrie doar text sau date binare. Un tablou de obiecte trebuie întâi transformat în text, iar formatul potrivit pentru date structurate este JSON. JSON.stringify(contacte, null, 2) produce textul, writeFileSync îl salvează, iar la citire JSON.parse reface tabloul de obiecte. Perechea stringify/parse este felul standard de a păstra date în fișiere JSON.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of ArrayTypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received type number (42)TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Promise
Cum o eviți pe viitor
- Scrie două funcții mici,
salveazaJson(fisier, date)șicitesteJson(fisier), și folosește-le peste tot. - Formatează JSON-ul salvat cu
JSON.stringify(date, null, 2), ca să fie ușor de citit. - Uită-te la finalul mesajului (
Received ...): îți spune exact ce tip ai trimis.
Întrebări frecvente
De ce nu transformă Node singur obiectul în JSON?
Pentru că un obiect se poate scrie în multe feluri (JSON, CSV, YAML). Node nu ghicește formatul, îl alegi tu.
Ce înseamnă argumentele null, 2 din JSON.stringify?
Al doilea argument filtrează proprietățile (null = toate), iar al treilea e indentarea: 2 spații pe nivel, ca fișierul să fie lizibil.
Erori înrudite
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ă. SyntaxError: /app/config.json: Expected double-quoted property name in JSON at position 59 (line 5 column 1) Fișierul JSON încărcat cu require are o greșeală de sintaxă: de obicei o virgulă după ultimul element, ghilimele simple sau un comentariu. Mesajul îți dă fișierul și linia; scoate virgula de la final și pune cheile între ghilimele duble. TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received type number (235) Ai dat lui res.write sau res.end (sau unui stream) un număr, un obiect ori un tablou, dar acceptă doar text sau Buffer. Transformă valoarea: res.end(String(total)) pentru numere, res.end(JSON.stringify(date)) pentru obiecte; în Express folosește res.json(date). Î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.
