CKTIS / JavaScript
SharedArrayBuffer — gemeinsam genutzter Binärspeicher
SharedArrayBuffer speichert Bytes, auf die verschiedene JavaScript-Agenten zugreifen können. Views interpretieren diese Bytes, während Atomics dabei hilft, nebenläufige Operationen zu koordinieren.
Version: 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 steht für einen gemeinsam genutzten Block binären Speichers, nicht für ein Zahlenarray. Der Konstruktor muss mit new aufgerufen werden; die Länge wird in Bytes angegeben, die anfangs mit Nullen gefüllt sind. Zum Lesen und Schreiben dienen Views wie Int32Array oder DataView. Anders als ein ArrayBuffer kann dieser Puffer nicht abgetrennt werden.
Das gemeinsame Nutzen allein sorgt nicht für Synchronisierung. Operationen wie view[0]++ sind keine atomaren Erhöhungen: Nebenläufige Aktualisierungen können verloren gehen. Verwende Atomics mit unterstützten ganzzahligen Views und einem durchdachten Kommunikationsprotokoll; mehrere atomare Aufrufe bilden nicht automatisch eine einzige Transaktion.
Ohne Optionen hat der Puffer eine feste Länge. Mit der Option { maxByteLength } lässt sich ein Puffer erstellen, der durch grow(newByteLength) vergrößert, aber nicht verkleinert werden kann. byteLength bezeichnet die aktuelle Größe, maxByteLength die Obergrenze.
Die Verfügbarkeit hängt von der Hostumgebung ab: Die Spezifikation erlaubt, den Konstruktor nicht bereitzustellen. ECMAScript allein belegt weder die Unterstützung in einem bestimmten Browser noch dessen Sicherheitsanforderungen; auch die Ausführung in Node beweist dies nicht. Das Beispiel prüft die Verfügbarkeit und verwendet zwei Views desselben Puffers, ohne nebenläufige Agenten zu starten.
Beispiele
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)}`);Ergebnis
4 10 15
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.