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

TypeError [ERR_INVALID_ARG_TYPE]: The "list[0]" argument must be an instance of Buffer or Uint8Array. Received type string ('{"id":')

Pe scurt

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

Greșit
JavaScript
req.on("data", (chunk) => bucati.push(chunk.toString()));
req.on("end", () => {
  const corp = Buffer.concat(bucati).toString();
});
Corect
JavaScript
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

Greșit
JavaScript
stream.setEncoding("utf8");
stream.on("data", (c) => bucati.push(c));
// ...
Buffer.concat(bucati);
Corect
JavaScript
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

Greșit
JavaScript
const tot = Buffer.concat(antet, corp);
Corect
JavaScript
const tot = Buffer.concat([antet, corp]);

Buffer.concat primește un singur tablou; al doilea argument opțional e lungimea totală.

Repară tu

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.

Codul care dă eroarea
JavaScript
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;
}
După reparație, programul afișează
Comanda #1042: Ana, 125 lei
Indiciu

Pune în bucati direct b, fără .toString().

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "list[1]" argument must be an instance of Buffer or Uint8Array. Received undefined
  • TypeError [ERR_INVALID_ARG_TYPE]: The "list" argument must be an instance of Array. Received an instance of Buffer
  • TypeError [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 cu join(""), fără Buffer.concat.
  • Pentru fișiere sau corpuri mari, preferă API-urile gata făcute: fs.promises.readFile, await req.json() (la fetch), 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

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