RangeError: Invalid atomic access index
O operație Atomics (add, load, store, sub, wait) a primit un index în afara tabloului tipizat, de obicei cu unu prea mare (numerotare de la 1 în loc de 0). Indexul valid e între 0 și tablou.length - 1; verifică-l înainte de operație.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Atomics face operații sigure pe memorie partajată între fire de execuție (workers): Atomics.add(tablou, index, valoare), Atomics.load, Atomics.store, Atomics.wait. Spre deosebire de accesul obișnuit tablou[index], care pentru un index în afara limitelor doar întoarce undefined sau ignoră scrierea, Atomics aruncă RangeError: Invalid atomic access index. Regula strictă e intenționată: în cod concurent, o scriere pierdută în tăcere ar fi foarte greu de depistat.
Cauza tipică e o greșeală de numerotare: workerii primesc id-uri de la 1 la 4, iar contoarele sunt la indicii 0–3. Alte cauze: un index calculat negativ, NaN sau un text din mesajul primit de la worker ("2" funcționează, dar "doi" nu).
Verifică indexul cu Number.isInteger(i) && i >= 0 && i < tablou.length înainte de operație.
De ce apare: cauzele frecvente
1Id de worker de la 1, indici de la 0
const contoare = new Int32Array(4);
Atomics.add(contoare, idWorker, 1); // idWorker între 1 și 4const contoare = new Int32Array(4);
Atomics.add(contoare, idWorker - 1, 1);Indicii încep de la 0, deci id-ul 4 corespunde poziției 3.
2Index primit dintr-un mesaj fără validare
onmessage = (e) => Atomics.store(stare, e.data.slot, 1);onmessage = (e) => {
const slot = Number(e.data.slot);
if (Number.isInteger(slot) && slot >= 0 && slot < stare.length) Atomics.store(stare, slot, 1);
};Datele din mesaje pot fi orice; validarea împiedică un index invalid.
Repară eroarea, direct în pagină
Fiecare worker (cu id de la 1 la 4) își incrementează contorul cu Atomics.add, dar workerul 4 dă RangeError: Invalid atomic access index. Repară funcția inregistreaza ca id-urile să fie transformate corect în indici și programul să afișeze Contoare: 1, 0, 0, 2.
const contoare = new Int32Array(4);
function inregistreaza(idWorker) {
Atomics.add(contoare, idWorker, 1);
}
inregistreaza(1);
inregistreaza(4);
inregistreaza(4);
console.log(`Contoare: ${Array.from(contoare).join(", ")}`);Contoare: 1, 0, 0, 2
Indiciu
Indicii tabloului încep de la 0, deci id-ul 1 este la poziția 0.
Reparația
const contoare = new Int32Array(4);
function inregistreaza(idWorker) {
Atomics.add(contoare, idWorker - 1, 1);
}
inregistreaza(1);
inregistreaza(4);
inregistreaza(4);
console.log(`Contoare: ${Array.from(contoare).join(", ")}`);De ce merge
Tabloul are 4 poziții, cu indicii de la 0 la 3. Id-ul 4 folosit direct ca index iese din tablou, iar Atomics aruncă eroare în loc să ignore scrierea. Cu idWorker - 1, workerul 1 scrie la poziția 0 și workerul 4 la poziția 3, unde contorul ajunge la 2.
Alte forme ale mesajului
RangeError: Invalid atomic access index at Atomics.addRangeError: Invalid atomic access index at Atomics.loadRangeError: invalid or out-of-range index
Cum o eviți pe viitor
- Păstrează o singură convenție de numerotare (de la 0) pentru sloturile din memoria partajată.
- Definește constante pentru poziții (
const SLOT_STARE = 0), nu calcula indici din id-uri externe. - Validează orice index care vine din mesaje între workers.
- Testează cu un singur worker și cu numărul maxim de workers.
Întrebări frecvente
Merge Atomics pe un tablou tipizat obișnuit, nu partajat?
Da, pentru add, load, store și altele. Doar Atomics.wait cere un Int32Array peste un SharedArrayBuffer.
De ce tablou[10] = 1 nu dă eroare, dar Atomics da?
Accesul obișnuit ignoră în tăcere indicii din afara limitelor. Atomics e gândit pentru cod concurent, unde regula strictă te ferește de erori ascunse.
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: Invalid index : 3 Array.prototype.with(index, valoare) poate doar înlocui un element existent, iar indexul dat e în afara tabloului (de exemplu egal cu length sau mai negativ decât -length). with nu adaugă elemente. Pentru adăugare folosește [...lista, valoare] sau toSpliced. 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.
