TypeError [ERR_INVALID_ARG_TYPE]: The "list[0]" argument must be an instance of Buffer or Uint8Array. Received type string ('{"id":')
Buffer.concat lipește doar Buffer-e, iar în listă ai și texte (de obicei bucăți transformate cu toString sau primite cu setEncoding). Păstrează bucățile ca Buffer și transformă în text abia la final, sau, dacă ai deja texte, lipește-le cu join("").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Buffer.concat(lista) primește un tablou de Buffer-e (sau Uint8Array) și întoarce unul singur. Mesajul îți spune poziția elementului greșit din tablou: list[0] e primul, list[2] al treilea, iar la final ce tip are (Received type string (...)).
Situația tipică: aduni corpul unei cereri HTTP sau conținutul unui stream din bucăți. Dacă ai apelat req.setEncoding("utf8") sau ai făcut chunk.toString() înainte de push, bucățile sunt deja texte și Buffer.concat le refuză.
Varianta The "list" argument must be an instance of Array înseamnă că n-ai dat un tablou deloc, ci bufferele ca argumente separate: Buffer.concat(a, b) în loc de Buffer.concat([a, b]).
De ce apare: cauzele frecvente
1Bucăți transformate în text prea devreme
req.on("data", (chunk) => bucati.push(chunk.toString()));
req.on("end", () => {
const corp = Buffer.concat(bucati).toString();
});req.on("data", (chunk) => bucati.push(chunk));
req.on("end", () => {
const corp = Buffer.concat(bucati).toString("utf8");
});Păstrate ca Buffer, bucățile se lipesc corect, iar conversia la text o faci o singură dată, la final. Așa nu se strică nici caracterele cu diacritice tăiate între două bucăți.
2Stream cu encoding setat
stream.setEncoding("utf8");
stream.on("data", (c) => bucati.push(c));
// ...
Buffer.concat(bucati);stream.setEncoding("utf8");
stream.on("data", (c) => bucati.push(c));
// ...
const text = bucati.join("");Cu setEncoding, stream-ul îți dă deja texte. Pe acestea le lipești cu join, nu cu Buffer.concat.
3Bufferele date ca argumente separate
const tot = Buffer.concat(antet, corp);const tot = Buffer.concat([antet, corp]);Buffer.concat primește un singur tablou; al doilea argument opțional e lungimea totală.
Repară eroarea, direct în pagină
Programul primește corpul unei comenzi în trei bucăți, ca de la un stream, dar le transformă în text înainte să le adune, iar Buffer.concat dă TypeError [ERR_INVALID_ARG_TYPE]: The "list[0]" argument must be an instance of Buffer or Uint8Array. Păstrează bucățile ca Buffer și convertește la text o singură dată, la final, ca programul să afișeze comanda.
const primite = [Buffer.from('{"id":'), Buffer.from('1042,"client":"Ana",'), Buffer.from('"total":125}')];
const bucati = [];
for (const b of primite) {
bucati.push(b.toString());
}
try {
const comanda = JSON.parse(Buffer.concat(bucati).toString("utf8"));
console.log(`Comanda #${comanda.id}: ${comanda.client}, ${comanda.total} lei`);
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}Comanda #1042: Ana, 125 lei
Indiciu
Pune în bucati direct b, fără .toString().
Reparația
const primite = [Buffer.from('{"id":'), Buffer.from('1042,"client":"Ana",'), Buffer.from('"total":125}')];
const bucati = [];
for (const b of primite) {
bucati.push(b);
}
try {
const comanda = JSON.parse(Buffer.concat(bucati).toString("utf8"));
console.log(`Comanda #${comanda.id}: ${comanda.client}, ${comanda.total} lei`);
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}De ce merge
Buffer.concat lipește doar obiecte Buffer (sau Uint8Array); primul element din listă era însă textul '{"id":', de aici list[0] din mesaj. Păstrând bucățile așa cum au venit, ele se lipesc într-un singur buffer, iar toString("utf8") de la final produce textul complet, pe care JSON.parse îl citește fără probleme. Conversia la final e și varianta sigură pentru diacriticele tăiate între bucăți.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "list[1]" argument must be an instance of Buffer or Uint8Array. Received undefinedTypeError [ERR_INVALID_ARG_TYPE]: The "list" argument must be an instance of Array. Received an instance of BufferTypeError [ERR_INVALID_ARG_TYPE]: The "list[0]" argument must be an instance of Buffer or Uint8Array. Received an instance of Object
Cum o eviți pe viitor
- Când aduni date din stream-uri sau cereri, păstrează bucățile ca
Bufferși convertește la final. - Dacă ai nevoie de text pe parcurs, alege de la început
setEncoding("utf8")și lipește cujoin(""), fărăBuffer.concat. - Pentru fișiere sau corpuri mari, preferă API-urile gata făcute:
fs.promises.readFile,await req.json()(lafetch),express.json().
Întrebări frecvente
De ce n-aș lipi direct textele cu +?
Un caracter cu diacritice are mai mulți octeți în UTF-8 și poate fi tăiat între două bucăți. Convertind fiecare bucată separat, obții caractere stricate (�). Lipind întâi octeții, conversia se face corect.
Ce înseamnă Received undefined la list[1]?
Tabloul are o poziție goală: un element neinițializat sau o funcție care nu a întors nimic. Afișează tabloul înainte de Buffer.concat ca să vezi ce conține.
Erori înrudite
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. 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). SyntaxError: Unexpected token 'o', "[object Obj"... is not valid JSON Serverul a primit textul "[object Object]" în loc de JSON, pentru că clientul a trimis un obiect în body fără JSON.stringify. Express răspunde cu 400 Bad Request. Scrie body: JSON.stringify(date) și antetul Content-Type: application/json. Î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.
