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

RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds

Pe scurt

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

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

Ce înseamnă

Mesajul apare când operația nu are cum să încapă, indiferent de poziție: bufferul are mai puțini octeți decât câmpul cerut. readUInt32BE, readInt32LE, readFloatBE au nevoie de 4 octeți, readDoubleBE și readBigInt64LE de 8, readUInt16BE de 2. Dacă bufferul (sau bucata obținută cu subarray/slice) e mai scurt, nu există niciun offset valid.

Diferența față de The value of "offset" is out of range: acolo bufferul e destul de mare, dar ai cerut o poziție greșită; aici bufferul e prea mic pentru tipul de câmp.

Cauze frecvente: ai ales funcția pentru alt tip de număr (32 de biți în loc de 16), ai tăiat bufferul prea scurt, ai primit un pachet incomplet sau un fișier gol. Stiva arată linia cu read.../write...; afișează acolo buf.length ca să vezi câți octeți ai de fapt.

De ce apare: cauzele frecvente

1Funcție pentru alt număr de octeți

Greșit
JavaScript
// temperatura e pe 2 octeți
const temp = pachet.subarray(2).readInt32BE(0);
Corect
JavaScript
const temp = pachet.subarray(2).readInt16BE(0);

readInt32BE citește 4 octeți, dar bucata are doar 2. readInt16BE citește exact cât are câmpul.

2Buffer gol sau incomplet

Greșit
JavaScript
const date = fs.readFileSync("senzor.bin");
const valoare = date.readFloatLE(0);
Corect
JavaScript
const date = fs.readFileSync("senzor.bin");
if (date.length < 4) throw new Error("Fișierul senzorului e incomplet");
const valoare = date.readFloatLE(0);

Un fișier gol (de exemplu încă nescris) are lungimea 0. Verificarea transformă eroarea criptică într-un mesaj clar.

3Scriere într-un buffer alocat prea mic

Greșit
JavaScript
const buf = Buffer.alloc(2);
buf.writeUInt32BE(1042);
Corect
JavaScript
const buf = Buffer.alloc(4);
buf.writeUInt32BE(1042);

Alocă bufferul cu dimensiunea tuturor câmpurilor pe care le scrii.

Repară tu

Repară eroarea, direct în pagină

Fiecare pachet de la senzori are 2 octeți pentru id și 2 octeți pentru temperatură (în zecimi de grad, cu semn). Programul dă RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds la citirea temperaturii. Folosește funcția potrivită pentru un număr cu semn pe 2 octeți, ca programul să afișeze temperatura fiecărui senzor.

Codul care dă eroarea
JavaScript
const pachete = [
  Buffer.from([0x00, 0x07, 0x00, 0xeb]),
  Buffer.from([0x00, 0x08, 0xff, 0xec]),
];

try {
  for (const p of pachete) {
    const id = p.readUInt16BE(0);
    const temp = p.subarray(2).readInt32BE(0) / 10;
    console.log(`Senzor ${id}: ${temp}°C`);
  }
} catch (err) {
  console.error(`${err.code}: ${err.message}`);
  process.exitCode = 1;
}
După reparație, programul afișează
Senzor 7: 23.5°C
Senzor 8: -2°C
Indiciu

Pentru 16 biți cu semn, big-endian, funcția este readInt16BE.

Alte forme ale mesajului

  • RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds at boundsError (node:internal/buffer)
  • RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: "length" is outside of buffer bounds
  • RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: "offset" is outside of buffer bounds

Cum o eviți pe viitor

  • Notează formatul binar cu dimensiunea fiecărui câmp și folosește funcția potrivită (Int16, Int32, Float, Double).
  • Verifică buf.length înainte de citire, mai ales pentru date din rețea sau din fișiere.
  • Pentru formate complexe, scrie o singură funcție de parsare, testată cu exemple scurte și incomplete.

Întrebări frecvente

Care e diferența dintre subarray și slice?

La Buffer, amândouă întorc o vedere peste aceeași memorie, fără copiere (slice e depreciat în favoarea lui subarray). Lungimea rezultatului e cea a bucății, deci citirile se fac relativ la ea, începând de la 0.

De ce mesajul nu spune lungimea bufferului?

Eroarea vine dintr-o verificare internă rapidă. Afișează tu buf.length și dimensiunea câmpului ca să vezi diferența.

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.