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

RangeError: Invalid atomic access index

Pe scurt

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

Greșit
JavaScript
const contoare = new Int32Array(4);
Atomics.add(contoare, idWorker, 1); // idWorker între 1 și 4
Corect
JavaScript
const 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

Greșit
JavaScript
onmessage = (e) => Atomics.store(stare, e.data.slot, 1);
Corect
JavaScript
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ă tu

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.

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

Indicii tabloului încep de la 0, deci id-ul 1 este la poziția 0.

Alte forme ale mesajului

  • RangeError: Invalid atomic access index at Atomics.add
  • RangeError: Invalid atomic access index at Atomics.load
  • RangeError: 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

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