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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Răspunsul HTTP (res) este un stream care trimite octeți către client. res.write(chunk) și res.end(chunk) acceptă doar string, Buffer sau Uint8Array. Dacă trimiți un număr, un obiect sau un tablou, Node aruncă ERR_INVALID_ARG_TYPE și îți spune la final ce a primit: Received type number (235) sau Received an instance of Object.
Greșeala tipică: vrei să răspunzi cu un total calculat (res.end(total)) sau cu o listă de obiecte (res.end(produse)), uitând că trebuie transformate în text. În Express, res.send(numar) se comportă diferit (consideră numărul cod de stare, într-o versiune veche), așa că pentru date folosește res.json().
Același mesaj îl primești la fs.createWriteStream(...).write(numar) sau process.stdout.write(numar).
De ce apare: cauzele frecvente
1Număr trimis direct
res.end(total);res.end(String(total));String() transformă numărul în text, pe care stream-ul îl poate trimite.
2Obiect sau tablou trimis direct
res.end(produse);res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify(produse));Datele structurate se trimit ca JSON, cu headerul potrivit.
3În Express, cu res.send și un număr
res.send(total);res.json({ total });res.json transformă singur obiectul în JSON și setează Content-Type.
Repară eroarea, direct în pagină
Serverul calculează totalul coșului și îl trimite cu res.end(total), iar prima cerere oprește serverul cu TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string... Received type number (235). Trimite totalul ca JSON ({ "total": 235 }), cu headerul potrivit, ca testul să afișeze tipul răspunsului și totalul.
const http = require("http");
const cos = [{ pret: 120, cantitate: 1 }, { pret: 57.5, cantitate: 2 }];
const server = http.createServer((req, res) => {
const total = cos.reduce((s, p) => s + p.pret * p.cantitate, 0);
res.writeHead(200);
res.end(total);
});
server.listen(3000, async () => {
const r = await fetch("http://localhost:3000/cos/total");
console.log(`Tip: ${r.headers.get("content-type")}`);
const date = await r.json();
console.log(`Total: ${date.total} lei`);
server.close();
});Tip: application/json Total: 235 lei
Indiciu
res.end(JSON.stringify({ total })), cu Content-Type: application/json setat în writeHead.
Reparația
const http = require("http");
const cos = [{ pret: 120, cantitate: 1 }, { pret: 57.5, cantitate: 2 }];
const server = http.createServer((req, res) => {
const total = cos.reduce((s, p) => s + p.pret * p.cantitate, 0);
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify({ total }));
});
server.listen(3000, async () => {
const r = await fetch("http://localhost:3000/cos/total");
console.log(`Tip: ${r.headers.get("content-type")}`);
const date = await r.json();
console.log(`Total: ${date.total} lei`);
server.close();
});De ce merge
res.end scrie octeți în conexiunea cu clientul și acceptă doar text sau date binare, nu numere. JSON.stringify({ total }) transformă obiectul în textul {"total":235}, iar headerul Content-Type: application/json îi spune clientului cum să-l interpreteze. În test, r.json() face JSON.parse pe corp și îți dă înapoi obiectul. Dacă voiai doar text simplu, res.end(String(total)) ar fi fost suficient.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received an instance of ObjectTypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received type number (42)TypeError: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received number
Cum o eviți pe viitor
- Scrie o funcție
trimiteJson(res, cod, date)și folosește-o pentru toate răspunsurile cu date. - În Express, răspunde cu
res.json()pentru date și cures.send()doar pentru text. - Când scrii în fișiere sau în
process.stdout, transformă numerele în text cuString()sau template literals.
Întrebări frecvente
De ce console.log acceptă numere și res.end nu?
console.log formatează orice valoare ca text înainte s-o afișeze. res.end scrie octeți direct în conexiune și lasă transformarea în seama ta.
Ce e chunk?
O bucată de date scrisă într-un stream. Un răspuns HTTP poate fi trimis în mai multe bucăți cu res.write(), iar ultima cu res.end().
Erori înrudite
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. Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client Încerci să trimiți al doilea răspuns la aceeași cerere: după res.end, res.send sau res.json ai mai apelat res.json, res.status sau res.setHeader. De obicei lipsește un return după răspunsul de eroare. Scrie return res.status(404).json(...). Error [ERR_STREAM_WRITE_AFTER_END]: write after end Ai scris într-un stream (fișier sau răspuns HTTP) după ce l-ai închis cu end(). După end() nu mai poți scrie. Scrie toate datele întâi și apelează end() o singură dată, la final; ca să faci ceva după scriere, ascultă evenimentul 'finish'. Î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.
