TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received undefined
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
const produs = produse.find((p) => p.id === id);
const corp = JSON.stringify(produs);
res.setHeader("Content-Length", Buffer.byteLength(corp));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
function construiesteRaspuns(date) {
JSON.stringify({ ok: true, date });
}
Buffer.byteLength(construiesteRaspuns(x));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
res.setHeader("Content-Length", corp.length);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ă 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.
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}`);
}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.
Reparația
const produse = [{ id: 1, nume: "Cafea măcinată", pret: 42 }];
function raspunsProdus(id) {
const produs = produse.find((p) => p.id === id);
if (!produs) {
const corp = JSON.stringify({ eroare: "Produs negăsit" });
return { status: 404, lungime: Buffer.byteLength(corp), corp };
}
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}`);
}De ce merge
Pentru id-ul 9, find nu găsește nimic, iar JSON.stringify(undefined) întoarce undefined, pe care Buffer.byteLength îl refuză. Cu verificarea if (!produs), cazul lipsă primește propriul corp JSON și codul 404. Observă și lungimea: „măcinată” are două litere cu diacritice, care ocupă câte 2 octeți, deci corpul are 44 de octeți, deși are 42 de caractere.
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 ObjectTypeError: 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)întoarceundefined, nu"undefined"și nici"null". - Folosește
Buffer.byteLength(nulength) pentruContent-Length; în Express,res.json()calculează singur antetul. - Scrie funcțiile care construiesc răspunsuri cu
returnexplicit ș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
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). 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. TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined Buffer.from() a primit undefined (sau un număr, un obiect) în loc de text sau octeți. De obicei valoarea vine dintr-o proprietate inexistentă, de exemplu req.headers.Authorization, când Node păstrează antetele cu litere mici. Verifică valoarea înainte de Buffer.from. Î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.
