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

RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 255. Received 300

Pe scurt

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.

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

Ce înseamnă

Funcțiile write... ale lui Buffer scriu un număr într-un câmp de dimensiune fixă. Fiecare tip are un interval: un octet fără semn (UInt8) ține 0-255, unul cu semn (Int8) ține -128..127, 16 biți fără semn țin 0-65535, 32 de biți fără semn până la 4294967295. Dacă valoarea e în afara intervalului, Node refuză scrierea, în loc s-o trunchieze în tăcere.

Mesajul spune intervalul tipului ales și valoarea primită. Dacă vezi It must be >= -128 and <= 127, ai folosit varianta cu semn (writeInt8); dacă vezi It must be an integer, valoarea are zecimale.

Atenție: atribuirea directă buf[0] = 300 nu dă eroare, ci păstrează doar ultimii 8 biți (300 devine 44). Metodele write... sunt mai sigure tocmai pentru că verifică.

De ce apare: cauzele frecvente

1Valoarea nu încape într-un octet

Greșit
JavaScript
const buf = Buffer.alloc(3);
cantitati.forEach((c, i) => buf.writeUInt8(c, i));
Corect
JavaScript
const buf = Buffer.alloc(cantitati.length * 2);
cantitati.forEach((c, i) => buf.writeUInt16BE(c, i * 2));

Cu 2 octeți pe valoare încap numere până la 65535. Offset-ul crește cu 2 pentru fiecare valoare.

2Tip cu semn pentru valori fără semn

Greșit
JavaScript
buf.writeInt8(200, 0);
Corect
JavaScript
buf.writeUInt8(200, 0);

Int8 folosește un bit pentru semn și ține doar până la 127. Pentru 0-255 ai nevoie de UInt8.

3Valoare cu zecimale

Greșit
JavaScript
buf.writeUInt16BE(23.5 * 10.01, 0);
Corect
JavaScript
buf.writeUInt16BE(Math.round(23.5 * 10), 0);

Câmpurile întregi acceptă doar numere întregi. Rotunjește explicit înainte de scriere.

Repară tu

Repară eroarea, direct în pagină

Programul salvează cantitățile din stoc într-un buffer, câte un octet pe cantitate, și dă RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 255. Received 300. Folosește 2 octeți pentru fiecare cantitate (16 biți fără semn, big-endian), ca toate valorile să încapă și să fie citite înapoi corect.

Codul care dă eroarea
JavaScript
const cantitati = [12, 250, 300];

try {
  const buf = Buffer.alloc(cantitati.length);
  cantitati.forEach((c, i) => buf.writeUInt8(c, i));

  const citite = cantitati.map((_, i) => buf.readUInt8(i));
  console.log(`Octeți: ${buf.length}`);
  console.log(`Cantități citite: ${citite.join(", ")}`);
} catch (err) {
  console.error(err.message);
  process.exitCode = 1;
}
După reparație, programul afișează
Octeți: 6
Cantități citite: 12, 250, 300
Indiciu

Alocă cantitati.length * 2 octeți, scrie cu writeUInt16BE(c, i * 2) și citește cu readUInt16BE(i * 2).

Alte forme ale mesajului

  • RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= -128 and <= 127. Received 200
  • RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 65535. Received 70000
  • RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 4294967295. Received -1
  • RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be an integer. Received 235.235

Cum o eviți pe viitor

  • Alege dimensiunea câmpului după cea mai mare valoare posibilă, nu după exemplele de test.
  • Validează datele înainte de serializare, cu un mesaj clar (Cantitatea ${c} depășește 65535).
  • Evită buf[i] = valoare pentru numere care pot depăși 255; folosește metodele write..., care verifică intervalul.

Întrebări frecvente

De ce buf[0] = 300 nu dă eroare?

Indexarea directă se comportă ca la Uint8Array: valoarea e redusă modulo 256, deci 300 devine 44. Eroarea lipsește, dar datele sunt greșite.

Ce fac dacă valorile depășesc și 32 de biți?

Folosește writeBigUInt64BE cu valori BigInt (de exemplu 1042n) sau writeDoubleBE pentru numere cu zecimale.

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.