...
Eroare Node.js · Buffer, crypto și assert

TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received undefined

Pe scurt

Buffer.byteLength() a primit undefined în loc de text, cel mai des pentru că JSON.stringify(undefined) întoarce undefined, nu un text. Asta se întâmplă când datele trimise lipsesc (find() nu a găsit nimic). Tratează lipsa datelor înainte, de exemplu cu un răspuns 404.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Buffer.byteLength(text) calculează câți octeți ocupă un text (de exemplu pentru antetul Content-Length). Nu e același lucru cu text.length: „ă”, „ș” sau emoji ocupă mai mulți octeți în UTF-8. Funcția acceptă text, Buffer sau ArrayBuffer; parametrul se numește string, de aici mesajul.

Valoarea undefined vine aproape întotdeauna din JSON.stringify. Pentru obiecte, tablouri, numere și null întoarce un text, dar pentru undefined (și pentru funcții) întoarce tot undefined. Deci Buffer.byteLength(JSON.stringify(produs)) pică exact când produs lipsește: un find() care nu a găsit nimic, o proprietate scrisă greșit, o funcție care a uitat return.

În stivă vezi linia cu Buffer.byteLength; caută de unde vine valoarea serializată.

De ce apare: cauzele frecvente

1Date lipsă trimise ca JSON

Greșit
JavaScript
const produs = produse.find((p) => p.id === id);
const corp = JSON.stringify(produs);
res.setHeader("Content-Length", Buffer.byteLength(corp));
Corect
JavaScript
const produs = produse.find((p) => p.id === id);
if (!produs) return trimite(res, 404, { eroare: "Produs negăsit" });
const corp = JSON.stringify(produs);
res.setHeader("Content-Length", Buffer.byteLength(corp));

Tratezi întâi cazul în care nu ai date; pentru un obiect real, JSON.stringify întoarce mereu text.

2Funcție care uită return

Greșit
JavaScript
function construiesteRaspuns(date) {
  JSON.stringify({ ok: true, date });
}
Buffer.byteLength(construiesteRaspuns(x));
Corect
JavaScript
function construiesteRaspuns(date) {
  return JSON.stringify({ ok: true, date });
}
Buffer.byteLength(construiesteRaspuns(x));

Fără return, funcția întoarce undefined.

3length în loc de byteLength

Greșit
JavaScript
res.setHeader("Content-Length", corp.length);
Corect
JavaScript
res.setHeader("Content-Length", Buffer.byteLength(corp));

Nu dă eroare, dar e o greșeală înrudită: cu diacritice, length numără caractere, nu octeți, iar răspunsul ajunge tăiat la client.

Repară tu

Repară eroarea, direct în pagină

Funcția raspunsProdus construiește corpul JSON și antetul Content-Length pentru un produs, dar pentru un id inexistent find întoarce undefined, JSON.stringify(undefined) dă tot undefined, iar Buffer.byteLength se oprește cu TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be .... Întoarce un răspuns 404 cu { eroare: "Produs negăsit" } când produsul nu există, ca programul să afișeze ambele răspunsuri.

Codul care dă eroarea
JavaScript
const produse = [{ id: 1, nume: "Cafea măcinată", pret: 42 }];

function raspunsProdus(id) {
  const produs = produse.find((p) => p.id === id);
  const corp = JSON.stringify(produs);
  return { status: 200, lungime: Buffer.byteLength(corp), corp };
}

for (const id of [1, 9]) {
  const r = raspunsProdus(id);
  console.log(`${id} -> ${r.status}, ${r.lungime} octeți: ${r.corp}`);
}
După reparație, programul afișează
1 -> 200, 44 octeți: {"id":1,"nume":"Cafea măcinată","pret":42}
9 -> 404, 28 octeți: {"eroare":"Produs negăsit"}
Indiciu

Verifică if (!produs) înainte de JSON.stringify și construiește atunci corpul erorii.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received type number (42)
  • TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received an instance of Object
  • TypeError: Cannot read properties of undefined (reading 'byteLength')

Cum o eviți pe viitor

  • Verifică datele înainte de serializare: if (!produs) return 404.
  • Amintește-ți că JSON.stringify(undefined) întoarce undefined, nu "undefined" și nici "null".
  • Folosește Buffer.byteLength (nu length) pentru Content-Length; în Express, res.json() calculează singur antetul.
  • Scrie funcțiile care construiesc răspunsuri cu return explicit și testează-le pe cazul „nu există”.

Întrebări frecvente

De ce JSON.stringify(null) merge, dar JSON.stringify(undefined) nu?

null e o valoare JSON validă și devine textul "null". undefined nu există în JSON, așa că JSON.stringify nu are ce text să producă și întoarce undefined.

Trebuie să pun eu Content-Length?

Nu e obligatoriu: fără el, Node trimite răspunsul în bucăți (chunked). Dacă îl pui, trebuie să fie exact numărul de octeți.

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.