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

TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received type string ('16')

Pe scurt

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

Greșit
JavaScript
const token = crypto.randomBytes(process.env.TOKEN_BYTES);
Corect
JavaScript
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

Greșit
JavaScript
{ "lungimeToken": "16" }
Corect
JavaScript
{ "lungimeToken": 16 }

În JSON, numerele se scriu fără ghilimele. Altfel JSON.parse îți dă un text.

3Dimensiune din req.query

Greșit
JavaScript
const buf = Buffer.alloc(req.query.marime);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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;
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received undefined
  • RangeError [ERR_OUT_OF_RANGE]: The value of "size" is out of range. It must be >= 0 && <= 9007199254740991. Received -1
  • TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received an instance of Object
  • RangeError [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), cu Number(...) ș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

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