...
Eroare JavaScript · Date binare: ArrayBuffer, TypedArray și DataView

RangeError: Offset is outside the bounds of the DataView

Pe scurt

Ai citit sau scris într-un DataView la o poziție la care nu mai încap toți octeții ceruți: de exemplu getUint32(6) pe un buffer de 8 octeți (ar trebui octeții 6–9). Verifică offset + dimensiune <= byteLength, mai ales în buclele care parcurg datele.

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

Ce înseamnă

DataView citește și scrie numere la poziții exacte într-un ArrayBuffer: getUint8 folosește un octet, getUint16 doi, getUint32 și getFloat32 patru, getFloat64 și getBigUint64 opt. Operația reușește doar dacă toți octeții încap: offset + dimensiune <= view.byteLength. Dacă nu încap, primești Offset is outside the bounds of the DataView, chiar dacă offsetul însuși e în interior.

Cauzele tipice: o buclă cu <= în loc de < sau care avansează din 1 în 1 în loc de 4 în 4; un fișier sau un mesaj de rețea mai scurt decât crezi (trunchiat, cu antet de altă dimensiune); un offset calculat greșit, de exemplu în biți în loc de octeți; un DataView creat peste o porțiune a bufferului (new DataView(buf, 4)), unde offsetul se socotește de la începutul porțiunii.

Afișează view.byteLength și offsetul la care se oprește codul. Formula offset + dimensiune > byteLength îți arată imediat depășirea.

De ce apare: cauzele frecvente

1Buclă care citește dincolo de final

Greșit
JavaScript
for (let i = 0; i <= view.byteLength; i += 4) {
  valori.push(view.getUint32(i));
}
Corect
JavaScript
for (let i = 0; i + 4 <= view.byteLength; i += 4) {
  valori.push(view.getUint32(i));
}

Condiția verifică faptul că toți cei patru octeți ai valorii încap în buffer.

2Pas greșit în buclă

Greșit
JavaScript
for (let i = 0; i < view.byteLength; i++) {
  sume.push(view.getFloat32(i, true));
}
Corect
JavaScript
for (let i = 0; i < view.byteLength; i += 4) {
  sume.push(view.getFloat32(i, true));
}

Un Float32 ocupă patru octeți, deci poziția avansează din patru în patru.

3Date mai scurte decât antetul așteptat

Greșit
JavaScript
const lungime = view.getUint32(0);
const versiune = view.getUint16(4);
Corect
JavaScript
if (view.byteLength < 6) throw new Error("Mesaj incomplet");
const lungime = view.getUint32(0);
const versiune = view.getUint16(4);

Verifici întâi că datele au cel puțin dimensiunea antetului.

Repară tu

Repară eroarea, direct în pagină

Funcția citesteTemperaturi parcurge un buffer de 12 octeți cu valori Int32, dar condiția buclei folosește <=, iar la ultimul pas getInt32 aruncă RangeError: Offset is outside the bounds of the DataView. Repară bucla ca programul să afișeze cele trei temperaturi.

Codul care dă eroarea
JavaScript
function citesteTemperaturi(buffer) {
  const view = new DataView(buffer);
  const valori = [];
  for (let i = 0; i <= view.byteLength; i += 4) {
    valori.push(view.getInt32(i, true));
  }
  return valori;
}

const date = new Int32Array([21, -3, 15]).buffer;
console.log(`Temperaturi: ${citesteTemperaturi(date).join(", ")}`);
După reparație, programul afișează
Temperaturi: 21, -3, 15
Indiciu

Fiecare valoare ocupă 4 octeți: condiția trebuie să verifice că încap toți.

Alte forme ale mesajului

  • RangeError: Offset is outside the bounds of the DataView at DataView.getUint32

Cum o eviți pe viitor

  • Scrie buclele de citire cu condiția i + dimensiune <= view.byteLength.
  • Folosește constante pentru dimensiuni (const OCTETI_UINT32 = 4) în loc de numere scrise direct.
  • Validează lungimea datelor primite înainte de parsare.
  • Testează parserul și pe date goale, trunchiate sau cu un octet în plus.

Întrebări frecvente

De ce eroarea apare la ultima valoare, nu la prima?

Pentru că primele valori încap în buffer. Doar ultima încercare depășește finalul, de obicei din cauza condiției buclei sau a unui buffer cu dimensiune care nu e multiplu de 4.

E diferit de citirea dincolo de un Uint8Array?

Da: tablou[100] pe un Uint8Array mai scurt întoarce undefined fără eroare. DataView e strict și aruncă RangeError.

Erori înrudite

← Toate erorile JavaScript

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ță JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.