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.
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ă
const [, cod] = req.headers.Authorization.split(" ");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
const cheie = Buffer.from(process.env.CHEIE_SECRETA, "hex");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
const buf = Buffer.from(16);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ă 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.
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}`);
}/admin: ana /rapoarte: mihai
Indiciu
Node păstrează numele antetelor cu litere mici.
Reparația
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}`);
}De ce merge
headers.Authorization nu există, deci String(undefined) dădea textul "undefined", fără niciun spațiu, iar a doua bucată de la split(" ") era undefined. Buffer.from(undefined, "base64") refuză valoarea. Cu headers.authorization, bucata a doua e textul Base64 YW5h..., pe care Buffer.from îl decodează în ana:parola123, iar utilizatorul e partea dinainte de :.
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 ObjectTypeError [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 șireq.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 șiBuffer.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
TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of ArrayBuffer, Buffer, TypedArray, DataView, KeyObject, or CryptoKey. Received undefined Cheia secretă dată lui crypto.createHmac (sau unei funcții de semnare, ca la JWT) e undefined: variabila de mediu nu e setată, fișierul de configurare nu are cheia sau numele proprietății e greșit. Verifică de unde vine cheia și oprește aplicația cu un mesaj clar dacă lipsește. TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64 Numele codificării dat lui Buffer.from, toString sau unei funcții din fs nu e recunoscut de Node: de obicei e scris cu cratimă sau greșit, de exemplu "base-64" sau "utf-16". Folosește numele acceptate: "utf8", "base64", "base64url", "hex", "latin1", "utf16le", "ascii". TypeError: Cannot destructure property 'nume' of 'req.body' as it is undefined. req.body este undefined pentru că Express nu citește singur corpul cererii: lipsește app.use(express.json()) (sau express.urlencoded() pentru formulare), e pus după rute, ori clientul nu trimite Content-Type: application/json. Adaugă middleware-ul înaintea rutelor. Î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.
