CKTIS / JavaScript
SharedArrayBuffer — memória binária partilhada
SharedArrayBuffer armazena bytes a que diferentes agentes JavaScript podem aceder. As vistas interpretam esses bytes, enquanto Atomics ajuda a coordenar operações concorrentes.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new SharedArrayBuffer(byteLength)
new SharedArrayBuffer(byteLength, { maxByteLength })SharedArrayBuffer representa um bloco de memória binária partilhada, não um array de números. O construtor requer new; o comprimento é indicado em bytes, inicialmente preenchidos com zeros. Para ler e escrever usam-se vistas como Int32Array ou DataView. Ao contrário de ArrayBuffer, este buffer não pode ser separado.
A partilha, por si só, não garante sincronização. Operações como view[0]++ não são incrementos atómicos: atualizações concorrentes podem perder-se. Usa Atomics em vistas inteiras suportadas e um protocolo de comunicação bem pensado; várias chamadas atómicas não formam automaticamente uma única transação.
Sem opções, o buffer tem um comprimento fixo. A opção { maxByteLength } permite criar um buffer que pode crescer através de grow(newByteLength), mas não diminuir. byteLength indica o tamanho atual; maxByteLength é o limite.
A disponibilidade depende do ambiente anfitrião: a especificação permite que o construtor não seja disponibilizado. O ECMAScript, por si só, não comprova o suporte num navegador específico nem os respetivos requisitos de segurança; a execução em Node também não o comprova. O exemplo verifica a disponibilidade e utiliza duas vistas do mesmo buffer sem iniciar agentes concorrentes.
Exemplos
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)}`);Resultado
4 10 15
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.