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

RangeError: Start offset 8 is outside the bounds of the buffer

Pe scurt

Ai creat un tablou tipizat sau un DataView peste un ArrayBuffer pornind de la un offset mai mare decât bufferul: de exemplu offset 8 pe un buffer de 4 octeți. De obicei datele sunt mai scurte decât antetul presupus. Verifică buffer.byteLength înainte să creezi fereastra.

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

Ce înseamnă

Când creezi o fereastră peste un buffer (new Uint8Array(buffer, offset, lungime) sau new DataView(buffer, offset)), offsetul trebuie să fie în interiorul bufferului. Dacă e mai mare decât buffer.byteLength, constructorul aruncă Start offset 8 is outside the bounds of the buffer, cu offsetul primit în mesaj. Dacă offsetul e bun, dar offset + lungime depășește finalul, mesajul devine Invalid typed array length: 4, iar la DataView apare Start offset 8 is outside the bounds of the buffer sau Invalid DataView length.

În practică, problema e aproape mereu că datele sunt mai scurte decât presupune codul: un mesaj gol sau doar cu antet, un fișier trunchiat, un buffer refolosit, mai mic. Altă cauză e confuzia dintre offsetul în octeți și indexul în elemente (new Float32Array(buffer, 3 * 4) versus 3).

Verifică lungimea datelor înainte de a crea fereastra și tratează explicit cazul „fără conținut”.

De ce apare: cauzele frecvente

1Mesaj fără conținut după antet

Greșit
JavaScript
const antet = 8;
const continut = new Uint8Array(buffer, antet);
Corect
JavaScript
const antet = 8;
const continut = buffer.byteLength > antet
  ? new Uint8Array(buffer, antet)
  : new Uint8Array(0);

Un mesaj care are doar antetul sau mai puțin nu are conținut. Tratezi cazul înainte de constructor.

2Lungime care depășește finalul

Greșit
JavaScript
const parte = new Uint8Array(buffer, 2, 4); // buffer de 4 octeți
Corect
JavaScript
const lungime = Math.min(4, buffer.byteLength - 2);
const parte = new Uint8Array(buffer, 2, lungime);

Lungimea ferestrei nu poate trece de finalul bufferului. Mesajul în acest caz e Invalid typed array length: 4.

3Offset în elemente în loc de octeți

Greșit
JavaScript
const v = new Float32Array(buffer, 3 * 4 * 4, 2);
Corect
JavaScript
const v = new Float32Array(buffer, 3 * 4, 2);

Al doilea argument e mereu în octeți. Pentru al patrulea Float32 (index 3) offsetul e 3 · 4 = 12.

Repară tu

Repară eroarea, direct în pagină

Funcția continutMesaj sare peste un antet de 4 octeți și întoarce restul datelor. Pentru un mesaj care are doar 2 octeți, new Uint8Array(buffer, 4) aruncă RangeError: Start offset 4 is outside the bounds of the buffer. Repară funcția ca mesajele prea scurte să aibă conținut gol, iar programul să afișeze lungimile.

Codul care dă eroarea
JavaScript
const ANTET = 4;

function continutMesaj(buffer) {
  return new Uint8Array(buffer, ANTET);
}

const complet = new Uint8Array([0, 0, 0, 3, 10, 20, 30]).buffer;
const scurt = new Uint8Array([0, 0]).buffer;
console.log(`Complet: ${continutMesaj(complet).length} octeți`);
console.log(`Scurt: ${continutMesaj(scurt).length} octeți`);
După reparație, programul afișează
Complet: 3 octeți
Scurt: 0 octeți
Indiciu

Verifică byteLength înainte să creezi fereastra și întoarce un Uint8Array gol dacă nu e conținut.

Alte forme ale mesajului

  • RangeError: Invalid typed array length: 4
  • RangeError: Start offset 8 is outside the bounds of the buffer at new Uint8Array
  • RangeError: Invalid DataView length 4

Cum o eviți pe viitor

  • Validează buffer.byteLength înainte de a crea ferestre peste el.
  • Calculează offseturile în octeți, cu Tablou.BYTES_PER_ELEMENT.
  • Tratează explicit mesajele goale sau trunchiate, cu o eroare clară sau un rezultat gol.
  • Testează parserul cu date de 0 octeți, doar cu antet și cu conținut parțial.

Întrebări frecvente

De ce offset egal cu byteLength e permis?

O fereastră care începe exact la final e validă și are lungimea 0. Eroarea apare doar când offsetul trece de final.

E la fel cu Offset is outside the bounds of the DataView?

Asemănător, dar acela apare la citire (getUint32), pe un DataView deja creat. Aici problema apare chiar la crearea ferestrei.

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.