Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

SharedArrayBuffer — memoria binaria condivisa

SharedArrayBuffer contiene byte accessibili da diversi agenti JavaScript. Le viste interpretano questi byte, mentre Atomics aiuta a coordinare le operazioni concorrenti.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

new SharedArrayBuffer(byteLength)
new SharedArrayBuffer(byteLength, { maxByteLength })

SharedArrayBuffer rappresenta un blocco di memoria binaria condivisa, non un array di numeri. Il costruttore richiede new; la lunghezza è espressa in byte, inizialmente impostati a zero. Per leggere e scrivere si usano viste come Int32Array o DataView. A differenza di ArrayBuffer, questo buffer non può essere scollegato.

La condivisione da sola non garantisce la sincronizzazione. Operazioni come view[0]++ non sono incrementi atomici: gli aggiornamenti concorrenti possono andare persi. Usa Atomics con viste intere supportate e un protocollo di comunicazione ben progettato; più chiamate atomiche non formano automaticamente un'unica transazione.

Senza opzioni, il buffer ha una lunghezza fissa. L’opzione { maxByteLength } consente di creare un buffer che può essere esteso con grow(newByteLength), ma non ridotto. byteLength indica la dimensione attuale; maxByteLength è il limite.

La disponibilità dipende dall’ambiente host: la specifica consente di non fornire il costruttore. ECMAScript da solo non dimostra il supporto in un determinato browser né i relativi requisiti di sicurezza; neppure l’esecuzione in Node lo dimostra. L’esempio verifica la disponibilità e usa due viste dello stesso buffer senza avviare agenti concorrenti.

Esempi

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)}`);

Risultato

4 10 15

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti