RangeError: Start offset 8 is outside the bounds of the buffer
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
const antet = 8;
const continut = new Uint8Array(buffer, antet);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
const parte = new Uint8Array(buffer, 2, 4); // buffer de 4 octețiconst 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
const v = new Float32Array(buffer, 3 * 4 * 4, 2);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ă 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.
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`);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.
Reparația
const ANTET = 4;
function continutMesaj(buffer) {
if (buffer.byteLength <= ANTET) {
return new Uint8Array(0);
}
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`);De ce merge
O fereastră Uint8Array peste un buffer trebuie să înceapă în interiorul lui. Mesajul scurt are doar 2 octeți, deci offsetul 4 e dincolo de final și constructorul aruncă RangeError. Verificarea byteLength <= ANTET tratează separat mesajele fără conținut și întoarce un tablou gol. Mesajul complet are 7 octeți, deci după antet rămân 3.
Alte forme ale mesajului
RangeError: Invalid typed array length: 4RangeError: Start offset 8 is outside the bounds of the buffer at new Uint8ArrayRangeError: 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
RangeError: Offset is outside the bounds of the DataView 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. RangeError: start offset of Float32Array should be a multiple of 4 Ai creat un tablou tipizat (Float32Array, Int32Array, Float64Array...) peste un ArrayBuffer, pornind de la un offset care nu e multiplu de dimensiunea elementului: de exemplu Float32Array la octetul 2. Copiază porțiunea cu buffer.slice(offset) sau citește valorile cu DataView, care acceptă orice offset. RangeError: offset is out of bounds Metoda set a unui tablou tipizat (tinta.set(sursa, offset)) a primit date care nu încap: offset + sursa.length e mai mare decât tinta.length. Apare des când lipești mai multe bucăți într-un buffer prea mic. Calculează întâi lungimea totală și creează ținta cu dimensiunea corectă. Î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.
