TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received type string ('16')
Buffer.alloc, Buffer.allocUnsafe și crypto.randomBytes primesc dimensiunea ca număr, iar tu ai dat un text (de obicei citit din process.env, dintr-un JSON sau din query string). Convertește valoarea cu Number(...) sau parseInt(..., 10) și verifică să fie un întreg pozitiv.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Argumentul size spune câți octeți să aibă bufferul nou: la Buffer.alloc(size), Buffer.allocUnsafe(size) și crypto.randomBytes(size). Node acceptă doar numere. Mesajul îți arată ce a primit: Received type string ('16') înseamnă textul "16", nu numărul 16.
Sursa e aproape mereu o configurare: variabilele de mediu sunt întotdeauna text (process.env.TOKEN_BYTES e "16"), la fel argumentele din linia de comandă (process.argv), parametrii din URL (req.query) și valorile din fișiere .env. Un JSON scris cu ghilimele ("lungime": "16") dă același rezultat.
Varianta Received undefined înseamnă că valoarea lipsește complet (variabilă de mediu nesetată, cheie scrisă greșit), iar RangeError ... The value of "size" is out of range înseamnă un număr negativ sau prea mare.
De ce apare: cauzele frecvente
1Dimensiunea vine din process.env
const token = crypto.randomBytes(process.env.TOKEN_BYTES);const bytes = Number(process.env.TOKEN_BYTES || 32);
const token = crypto.randomBytes(bytes);Number transformă textul în număr, iar || 32 dă o valoare implicită când variabila lipsește.
2Valoare scrisă ca text în JSON
{ "lungimeToken": "16" }{ "lungimeToken": 16 }În JSON, numerele se scriu fără ghilimele. Altfel JSON.parse îți dă un text.
3Dimensiune din req.query
const buf = Buffer.alloc(req.query.marime);const marime = parseInt(req.query.marime, 10);
if (!Number.isInteger(marime) || marime <= 0 || marime > 1024) {
return res.status(400).json({ eroare: "Mărime invalidă" });
}
const buf = Buffer.alloc(marime);Datele din cerere trebuie convertite și limitate; altfel un client poate cere un buffer uriaș.
Repară eroarea, direct în pagină
Programul generează tokenuri de resetare a parolei, cu lungimea citită din configurație, și dă TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received type string ('16'). Convertește lungimea în număr înainte de crypto.randomBytes, ca programul să afișeze lungimea tokenurilor generate.
const crypto = require("crypto");
// așa vine configurația dintr-un fișier .env: totul e text
const config = { octetiToken: "16" };
try {
for (const email of ["ana@exemplu.ro", "mihai@exemplu.ro"]) {
const token = crypto.randomBytes(config.octetiToken).toString("hex");
console.log(`${email}: token de ${token.length} caractere`);
}
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}ana@exemplu.ro: token de 32 caractere mihai@exemplu.ro: token de 32 caractere
Indiciu
Valoarea din configurație e textul "16"; Number(config.octetiToken) îl transformă în numărul 16.
Reparația
const crypto = require("crypto");
// așa vine configurația dintr-un fișier .env: totul e text
const config = { octetiToken: "16" };
const octeti = Number(config.octetiToken);
try {
for (const email of ["ana@exemplu.ro", "mihai@exemplu.ro"]) {
const token = crypto.randomBytes(octeti).toString("hex");
console.log(`${email}: token de ${token.length} caractere`);
}
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}De ce merge
crypto.randomBytes cere numărul de octeți ca number, iar valorile din .env sau din process.env sunt mereu text. Number("16") dă 16, așa că se generează 16 octeți aleatori, care în hexazecimal înseamnă 32 de caractere. Conversia făcută o singură dată, lângă configurație, te scutește de aceeași eroare în toate locurile unde folosești valoarea.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received undefinedRangeError [ERR_OUT_OF_RANGE]: The value of "size" is out of range. It must be >= 0 && <= 9007199254740991. Received -1TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received an instance of ObjectRangeError [ERR_OUT_OF_RANGE]: The value of "size" is out of range. It must be >= 0 && <= 2147483647. Received 4294967296
Cum o eviți pe viitor
- Convertește toată configurarea la pornire, într-un singur modul (
config.js), cuNumber(...)și valori implicite. - Validează că dimensiunile sunt întregi pozitive și au o limită superioară.
- În JSON, scrie numerele fără ghilimele.
- Pentru variabilele de mediu obligatorii, oprește pornirea aplicației cu un mesaj clar dacă lipsesc, în loc să lași eroarea să apară mai târziu.
Întrebări frecvente
De ce process.env.PORT funcționează la listen, dar nu aici?
server.listen acceptă și text care arată ca un număr și îl convertește singur. Buffer.alloc și randomBytes sunt stricte: cer exact tipul number.
Ce lungime are un token din randomBytes(16).toString("hex")?
32 de caractere: fiecare octet devine două cifre hexazecimale. În base64url, aceiași 16 octeți dau 22 de caractere.
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. RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 255. Received 300 Numărul pe care îl scrii nu încape în tipul ales: writeUInt8 acceptă 0-255, writeInt8 -128..127, writeUInt16BE 0-65535. Alege un tip mai mare (writeUInt16BE, writeUInt32BE) și alocă bufferul cu octeții necesari, sau validează valoarea înainte. TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined Ai dat unei funcții din fs sau path o cale care este undefined, nu un text. De obicei vine din process.argv[2] lipsă, o proprietate scrisă greșit sau o variabilă de mediu nesetată. Verifică variabila și pune o valoare implicită. Î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.
