CKTIS / JavaScript
SharedArrayBuffer — zdieľaná binárna pamäť
SharedArrayBuffer uchováva bajty, ku ktorým môžu pristupovať rôzni agenti JavaScriptu. Pohľady tieto bajty interpretujú a Atomics pomáha koordinovať súbežné operácie.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new SharedArrayBuffer(byteLength)
new SharedArrayBuffer(byteLength, { maxByteLength })SharedArrayBuffer predstavuje blok zdieľanej binárnej pamäte, nie pole čísel. Jeho konštruktor vyžaduje new; dĺžka sa udáva v bajtoch, ktoré sú spočiatku vyplnené nulami. Na čítanie a zápis slúžia pohľady, napríklad Int32Array alebo DataView. Na rozdiel od ArrayBuffer sa tento buffer nedá odpojiť.
Samotné zdieľanie nezabezpečuje synchronizáciu. Operácie ako view[0]++ nie sú atómové zvýšenia: súbežné aktualizácie sa môžu stratiť. Používajte Atomics s podporovanými celočíselnými pohľadmi a premysleným komunikačným protokolom; niekoľko atómových volaní automaticky netvorí jednu transakciu.
Bez možností má buffer pevnú dĺžku. Možnosť { maxByteLength } vytvorí buffer, ktorý možno zväčšiť pomocou grow(newByteLength), no nemožno ho zmenšiť. byteLength označuje aktuálnu veľkosť a maxByteLength limit.
Dostupnosť závisí od hostiteľského prostredia: špecifikácia umožňuje konštruktor neposkytnúť. Samotný ECMAScript nedokladá podporu v konkrétnom prehliadači ani jeho bezpečnostné požiadavky; nedokladá ich ani spustenie v Node. Príklad kontroluje dostupnosť a používa dva pohľady na ten istý buffer bez spustenia súbežných agentov.
Prí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ýsledok
4 10 15
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.