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

RangeError: offset is out of bounds

Pe scurt

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

Greșit
JavaScript
const rezultat = new Uint8Array(bucati[0].length);
let poz = 0;
for (const b of bucati) { rezultat.set(b, poz); poz += b.length; }
Corect
JavaScript
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

Greșit
JavaScript
const v = new Uint8Array(4);
v.set([1, 2], 3);
Corect
JavaScript
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

Greșit
JavaScript
const tinta = new Float32Array(4);
tinta.set(new Float32Array([1, 2]), 2 * 4);
Corect
JavaScript
const tinta = new Float32Array(4);
tinta.set(new Float32Array([1, 2]), 2);

Offsetul lui set e în elemente, nu în octeți.

Repară tu

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.

Codul care dă eroarea
JavaScript
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(" ")}`);
După reparație, programul afișează
Octeți: 1 2 3 4 5 6
Indiciu

Adună lungimile tuturor bucăților înainte să creezi ținta.

Alte forme ale mesajului

  • RangeError: offset is out of bounds at Uint8Array.set
  • RangeError: 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 set cu lungimea bucății copiate.
  • Ține minte unitatea: offsetul lui set e î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

← 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.