Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje