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

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

Pe scurt

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.

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

Ce înseamnă

Buffer.from(valoare) construiește un șir de octeți dintr-un text ("abc", "YW5h" cu "base64"), dintr-un tablou de numere sau din alt buffer. Mesajul enumeră exact tipurile acceptate și îți spune ce ai dat de fapt: Received undefined, Received type number (42), Received an instance of Object.

undefined înseamnă aproape întotdeauna că proprietatea din care ai luat valoarea nu există. Un caz foarte des întâlnit în Node: antetele HTTP sunt păstrate cu litere mici în req.headers, deci req.headers.Authorization e undefined, iar req.headers.authorization are valoarea. La fel la un token lipsă, o variabilă de mediu nesetată sau un câmp JSON redenumit.

La un număr, cauza e alta: Buffer.from(10) nu creează 10 octeți; pentru asta există Buffer.alloc(10).

De ce apare: cauzele frecvente

1Antet HTTP scris cu majusculă

Greșit
JavaScript
const [, cod] = req.headers.Authorization.split(" ");
Corect
JavaScript
const antet = req.headers.authorization || "";
const [, cod] = antet.split(" ");

Node pune numele antetelor cu litere mici în req.headers. Valoarea implicită "" evită eroarea când antetul lipsește.

2Valoare lipsă dintr-o variabilă sau un obiect

Greșit
JavaScript
const cheie = Buffer.from(process.env.CHEIE_SECRETA, "hex");
Corect
JavaScript
if (!process.env.CHEIE_SECRETA) throw new Error("Lipsește CHEIE_SECRETA");
const cheie = Buffer.from(process.env.CHEIE_SECRETA, "hex");

Un mesaj propriu spune imediat ce lipsește, în loc de o eroare generică despre tipuri.

3Număr în loc de mărime

Greșit
JavaScript
const buf = Buffer.from(16);
Corect
JavaScript
const buf = Buffer.alloc(16);

Buffer.alloc(n) creează un buffer de n octeți umplut cu zero. Buffer.from primește conținutul, nu mărimea.

Repară tu

Repară eroarea, direct în pagină

Programul decodează autentificarea Basic din antetele unor cereri, dar citește antetul cu majusculă (Authorization), care nu există în headers, așa că Buffer.from primește undefined și dă TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string .... Citește antetul cu numele corect, ca programul să afișeze utilizatorul din fiecare cerere.

Codul care dă eroarea
JavaScript
const cereri = [
  { url: "/admin", headers: { authorization: "Basic YW5hOnBhcm9sYTEyMw==" } },
  { url: "/rapoarte", headers: { authorization: "Basic bWloYWk6Y2FmZWEyMDI2" } },
];

for (const cerere of cereri) {
  const [, cod] = String(cerere.headers.Authorization).split(" ");
  const [utilizator] = Buffer.from(cod, "base64").toString("utf8").split(":");
  console.log(`${cerere.url}: ${utilizator}`);
}
După reparație, programul afișează
/admin: ana
/rapoarte: mihai
Indiciu

Node păstrează numele antetelor cu litere mici.

Alte forme ale mesajului

  • 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 type number (16)
  • 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 an instance of Object
  • 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 null

Cum o eviți pe viitor

  • Citește antetele HTTP mereu cu litere mici: req.headers.authorization, req.headers["content-type"] (în Express poți folosi și req.get("Authorization")).
  • Verifică datele care vin din afară (antete, variabile de mediu, JSON) înainte să le transformi.
  • Folosește Buffer.alloc(n) pentru buffere goale și Buffer.from(...) pentru conținut.
  • Pentru obiecte, transformă-le întâi în text: Buffer.from(JSON.stringify(obiect)).

Întrebări frecvente

De ce req.headers.Authorization e undefined, deși clientul trimite antetul?

Numele antetelor HTTP nu țin cont de litere mari și mici, iar Node le salvează pe toate cu litere mici. Antetul există, dar se numește authorization.

Cum decodez un text Base64?

Buffer.from(text, "base64").toString("utf8"). Invers: Buffer.from(text).toString("base64").

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.