CKTIS / JavaScript
SharedArrayBuffer — gedeeld binair geheugen
SharedArrayBuffer bevat bytes die door verschillende JavaScript-agents kunnen worden benaderd. Views interpreteren die bytes, terwijl Atomics helpt om gelijktijdige bewerkingen te coördineren.
Versie: 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 staat voor een blok gedeeld binair geheugen, niet voor een array met getallen. De constructor vereist new; de lengte wordt opgegeven in bytes, die aanvankelijk met nullen zijn gevuld. Lezen en schrijven doe je via views zoals Int32Array of DataView. In tegenstelling tot ArrayBuffer kan deze buffer niet worden losgekoppeld.
Delen alleen zorgt niet voor synchronisatie. Bewerkingen zoals view[0]++ zijn geen atomaire verhogingen: gelijktijdige updates kunnen verloren gaan. Gebruik Atomics op ondersteunde integer-views en met een doordacht communicatieprotocol; meerdere atomaire aanroepen vormen niet automatisch één transactie.
Zonder opties heeft de buffer een vaste lengte. Met de optie { maxByteLength } maak je een buffer die via grow(newByteLength) kan groeien, maar niet kleiner kan worden. byteLength is de huidige grootte; maxByteLength is de limiet.
De beschikbaarheid hangt af van de hostomgeving: de specificatie staat toe dat de constructor ontbreekt. ECMAScript alleen toont niet aan dat een bepaalde browser dit ondersteunt of welke beveiligingseisen daar gelden; uitvoering in Node bewijst dat evenmin. Het voorbeeld controleert de beschikbaarheid en gebruikt twee views van dezelfde buffer zonder gelijktijdige agents te starten.
Voorbeelden
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)}`);Resultaat
4 10 15
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.