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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
tinta.set(sursa, offset) copiază elementele din sursa (un tablou obișnuit sau tipizat) în tinta, începând de la poziția offset. Spre deosebire de atribuirile individuale, care ignoră în tăcere indexurile din afara tabloului, set verifică dinainte că toate elementele încap: offset + sursa.length <= tinta.length. Dacă nu, aruncă offset is out of bounds și nu copiază nimic. Același mesaj apare și dacă offset e negativ.
Scenariul clasic e lipirea mai multor bucăți (chunks) primite dintr-un stream sau dintr-un upload: creezi ținta cu o dimensiune estimată sau cu lungimea primei bucăți, apoi set-ul pentru o bucată ulterioară depășește. Alte cauze: offsetul nu e actualizat după fiecare bucată, așa că bucățile se suprapun și ultima iese din tablou; offsetul e calculat în octeți, dar ținta are elemente mai mari (de exemplu Float32Array).
Calculează lungimea totală înainte să creezi ținta și mută offsetul după fiecare copiere.
De ce apare: cauzele frecvente
1Buffer creat cu dimensiunea primei bucăți
const rezultat = new Uint8Array(bucati[0].length);
let poz = 0;
for (const b of bucati) { rezultat.set(b, poz); poz += b.length; }const total = bucati.reduce((s, b) => s + b.length, 0);
const rezultat = new Uint8Array(total);
let poz = 0;
for (const b of bucati) { rezultat.set(b, poz); poz += b.length; }Lungimea totală se calculează înainte, ca toate bucățile să încapă.
2Copiere la finalul unui tablou plin
const v = new Uint8Array(4);
v.set([1, 2], 3);const v = new Uint8Array(5);
v.set([1, 2], 3);Pozițiile 3 și 4 trebuie să existe. Ținta are nevoie de cel puțin offset + lungime elemente.
3Offset în octeți pentru o țintă cu elemente de 4 octeți
const tinta = new Float32Array(4);
tinta.set(new Float32Array([1, 2]), 2 * 4);const tinta = new Float32Array(4);
tinta.set(new Float32Array([1, 2]), 2);Offsetul lui set e în elemente, nu în octeți.
Repară eroarea, direct în pagină
Funcția lipeste unește bucățile primite dintr-un upload într-un singur Uint8Array, dar creează ținta cu lungimea primei bucăți, iar al doilea set aruncă RangeError: offset is out of bounds. Repară funcția ca ținta să aibă lungimea totală și programul să afișeze octeții uniți.
function lipeste(bucati) {
const rezultat = new Uint8Array(bucati[0].length);
let pozitie = 0;
for (const bucata of bucati) {
rezultat.set(bucata, pozitie);
pozitie += bucata.length;
}
return rezultat;
}
const bucati = [new Uint8Array([1, 2, 3]), new Uint8Array([4, 5]), new Uint8Array([6])];
console.log(`Octeți: ${lipeste(bucati).join(" ")}`);Octeți: 1 2 3 4 5 6
Indiciu
Adună lungimile tuturor bucăților înainte să creezi ținta.
Reparația
function lipeste(bucati) {
const total = bucati.reduce((suma, b) => suma + b.length, 0);
const rezultat = new Uint8Array(total);
let pozitie = 0;
for (const bucata of bucati) {
rezultat.set(bucata, pozitie);
pozitie += bucata.length;
}
return rezultat;
}
const bucati = [new Uint8Array([1, 2, 3]), new Uint8Array([4, 5]), new Uint8Array([6])];
console.log(`Octeți: ${lipeste(bucati).join(" ")}`);De ce merge
Tablourile tipizate au lungime fixă, iar set verifică dinainte că toată sursa încape de la offsetul dat. Ținta avea doar 3 elemente, deci a doua bucată, copiată de la poziția 3, nu mai avea loc. Cu reduce calculăm lungimea totală, 6, creăm ținta cu această dimensiune, iar fiecare bucată ajunge în continuarea celei de dinainte.
Alte forme ale mesajului
RangeError: offset is out of bounds at Uint8Array.setRangeError: Source is too large
Cum o eviți pe viitor
- Înainte de a lipi bucăți, calculează lungimea totală cu
reduce. - Actualizează offsetul după fiecare
setcu lungimea bucății copiate. - Ține minte unitatea: offsetul lui
sete în elemente, offsetul constructorului e în octeți. - Pentru date de dimensiune necunoscută, adună bucățile într-un tablou și concatenează-le o singură dată la final.
Întrebări frecvente
De ce atribuirea tinta[10] = 5 nu dă eroare, iar set da?
Atribuirea pe un index inexistent al unui tablou tipizat e ignorată în tăcere. set e o copiere în bloc și verifică dinainte că încape tot, ca să nu lase datele pe jumătate copiate.
Există o metodă gata făcută pentru concatenare?
Pentru tablouri tipizate nu există un concat. În browser poți folosi new Blob(bucati).arrayBuffer(), iar în Node Buffer.concat(bucati).
Erori înrudite
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: 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: 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.
