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

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

Pe scurt

Î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

Greșit
JavaScript
fs.writeFileSync("contacte.json", contacte);
Corect
JavaScript
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

Greșit
JavaScript
fs.writeFileSync("contor.txt", 42);
Corect
JavaScript
fs.writeFileSync("contor.txt", String(42));

Și numerele trebuie transformate în text înainte de scriere.

3Promisiunea în loc de date

Greșit
JavaScript
const date = obtineDate(); // funcție async
fs.writeFileSync("date.json", date);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Ana Pop: 0722000111
Mihai Ionescu: 0733000222
Indiciu

JSON.stringify(lista, null, 2) transformă tabloul în text JSON cu indentare de 2 spații.

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 Array
  • TypeError [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) și citesteJson(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

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