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.
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
const buf = Buffer.alloc(3);
cantitati.forEach((c, i) => buf.writeUInt8(c, i));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
buf.writeInt8(200, 0);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
buf.writeUInt16BE(23.5 * 10.01, 0);buf.writeUInt16BE(Math.round(23.5 * 10), 0);Câmpurile întregi acceptă doar numere întregi. Rotunjește explicit înainte de scriere.
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.
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;
}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).
Reparația
const cantitati = [12, 250, 300];
try {
const buf = Buffer.alloc(cantitati.length * 2);
cantitati.forEach((c, i) => buf.writeUInt16BE(c, i * 2));
const citite = cantitati.map((_, i) => buf.readUInt16BE(i * 2));
console.log(`Octeți: ${buf.length}`);
console.log(`Cantități citite: ${citite.join(", ")}`);
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}De ce merge
Un octet fără semn ține doar valori între 0 și 255, așa că writeUInt8(300) e refuzat. Cu 16 biți pe valoare încap numere până la 65535: bufferul are acum 2 octeți pentru fiecare cantitate, iar poziția de scriere și de citire este i * 2. Citirea trebuie făcută cu aceeași funcție și aceeași ordine a octeților (BE) cu care s-a scris, altfel numerele ies greșite.
Alte forme ale mesajului
RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= -128 and <= 127. Received 200RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 65535. Received 70000RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 4294967295. Received -1RangeError [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] = valoarepentru numere care pot depăși 255; folosește metodelewrite..., 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
RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out of range. It must be >= 0 and <= 3. Received 4 Citești sau scrii într-un Buffer la o poziție (offset) care depășește lungimea lui. Mesajul îți dă intervalul permis și valoarea primită. De obicei e o buclă cu i <= buf.length în loc de i < buf.length, sau un câmp citit dintr-un pachet mai scurt decât crezi. RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds Încerci să citești sau să scrii un câmp mai mare decât tot bufferul, de exemplu 4 octeți (readInt32BE) dintr-un buffer de 2. Verifică dimensiunea câmpului din format (16 sau 32 de biți?) și lungimea bufferului, de obicei rezultatul unui slice sau subarray. 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. Î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.
