CKTIS / JavaScript
SharedArrayBuffer — sdílená binární paměť
SharedArrayBuffer uchovává bajty, ke kterým mohou přistupovat různí agenti JavaScriptu. Pohledy tyto bajty interpretují a Atomics pomáhá koordinovat souběžné operace.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new SharedArrayBuffer(byteLength)
new SharedArrayBuffer(byteLength, { maxByteLength })SharedArrayBuffer představuje blok sdílené binární paměti, nikoli pole čísel. Jeho konstruktor vyžaduje new; délka se udává v bajtech, které jsou zpočátku vyplněny nulami. Ke čtení a zápisu slouží pohledy, například Int32Array nebo DataView. Na rozdíl od ArrayBuffer nelze tento buffer odpojit.
Samotné sdílení nezajišťuje synchronizaci. Operace jako view[0]++ nejsou atomická zvýšení: souběžné aktualizace se mohou ztratit. Používejte Atomics s podporovanými celočíselnými pohledy a promyšleným komunikačním protokolem; několik atomických volání automaticky netvoří jednu transakci.
Bez dalších možností má buffer pevnou délku. Možnost { maxByteLength } vytvoří buffer, který lze zvětšit pomocí grow(newByteLength), ale nelze jej zmenšit. byteLength označuje aktuální velikost, maxByteLength limit.
Dostupnost závisí na hostitelském prostředí: specifikace dovoluje konstruktor nezpřístupnit. Samotný ECMAScript nedokládá podporu v konkrétním prohlížeči ani jeho bezpečnostní požadavky; nedokládá je ani spuštění v Node. Příklad ověřuje dostupnost a používá dva pohledy na stejný buffer, aniž spouští souběžné agenty.
Příklady
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)}`);Výsledek
4 10 15
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.