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.
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
for (let i = 0; i <= view.byteLength; i += 4) {
valori.push(view.getUint32(i));
}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ă
for (let i = 0; i < view.byteLength; i++) {
sume.push(view.getFloat32(i, true));
}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
const lungime = view.getUint32(0);
const versiune = view.getUint16(4);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ă 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.
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(", ")}`);Temperaturi: 21, -3, 15
Indiciu
Fiecare valoare ocupă 4 octeți: condiția trebuie să verifice că încap toți.
Reparația
function citesteTemperaturi(buffer) {
const view = new DataView(buffer);
const valori = [];
for (let i = 0; i + 4 <= 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(", ")}`);De ce merge
Bufferul are 12 octeți, adică trei valori de câte 4 octeți, la pozițiile 0, 4 și 8. Cu <=, bucla mai încerca un pas la poziția 12, unde nu mai există niciun octet. Condiția i + 4 <= view.byteLength cere ca valoarea întreagă să încapă, deci bucla se oprește după poziția 8. Al doilea argument, true, citește în ordinea little-endian în care a scris Int32Array.
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
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: 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. RangeError: Invalid array length Ai cerut un tablou cu o lungime imposibilă: negativă, cu zecimale, `NaN` sau mai mare decât limita de aproximativ 4,29 miliarde. Cel mai des, `new Array(n)` primește un `n` calculat greșit. Verifică valoarea lui `n` înainte să creezi tabloul. Î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.
