CKTIS / JavaScript
SharedArrayBuffer — zajednička binarna memorija
SharedArrayBuffer pohranjuje bajtove kojima mogu pristupati različiti JavaScript agenti. Pogledi tumače te bajtove, a Atomics pomaže koordinirati istodobne operacije.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new SharedArrayBuffer(byteLength)
new SharedArrayBuffer(byteLength, { maxByteLength })SharedArrayBuffer predstavlja blok zajedničke binarne memorije, a ne polje brojeva. Njegov konstruktor zahtijeva new; duljina se navodi u bajtovima koji su u početku ispunjeni nulama. Za čitanje i pisanje služe pogledi kao što su Int32Array ili DataView. Za razliku od ArrayBuffer, ovaj se međuspremnik ne može odvojiti.
Samo dijeljenje ne osigurava sinkronizaciju. Operacije poput view[0]++ nisu atomska povećanja: istodobna ažuriranja mogu se izgubiti. Upotrebljavajte Atomics na podržanim cjelobrojnim pogledima i uz promišljen komunikacijski protokol; nekoliko atomskih poziva ne čini automatski jednu transakciju.
Bez opcija međuspremnik ima fiksnu duljinu. Opcija { maxByteLength } omogućuje stvaranje međuspremnika koji se može povećati pomoću grow(newByteLength), ali ne i smanjiti. byteLength označava trenutačnu veličinu, a maxByteLength ograničenje.
Dostupnost ovisi o okruženju domaćina: specifikacija dopušta da konstruktor ne bude dostupan. Sam ECMAScript ne potvrđuje podršku u određenom pregledniku ni njegove sigurnosne zahtjeve; to ne dokazuje ni izvođenje u Nodeu. Primjer provjerava dostupnost i koristi dva pogleda istog međuspremnika bez pokretanja istodobnih agenata.
Primjeri
if (typeof SharedArrayBuffer === "undefined") {
throw new Error("SharedArrayBuffer unavailable");
}
const buffer = new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT);
const first = new Int32Array(buffer);
const second = new Int32Array(buffer);
Atomics.store(first, 0, 10);
const previous = Atomics.add(second, 0, 5);
console.log(`${buffer.byteLength} ${previous} ${Atomics.load(first, 0)}`);Rezultat
4 10 15
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.