...
Eroare Node.js · Server HTTP, fetch și porturi

TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received type number (235)

Pe scurt

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

Greșit
JavaScript
res.end(total);
Corect
JavaScript
res.end(String(total));

String() transformă numărul în text, pe care stream-ul îl poate trimite.

2Obiect sau tablou trimis direct

Greșit
JavaScript
res.end(produse);
Corect
JavaScript
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

Greșit
JavaScript
res.send(total);
Corect
JavaScript
res.json({ total });

res.json transformă singur obiectul în JSON și setează Content-Type.

Repară tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
Tip: application/json
Total: 235 lei
Indiciu

res.end(JSON.stringify({ total })), cu Content-Type: application/json setat în writeHead.

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 Object
  • TypeError [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 cu res.send() doar pentru text.
  • Când scrii în fișiere sau în process.stdout, transformă numerele în text cu String() 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

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