Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

SharedArrayBuffer — mémoire binaire partagée

SharedArrayBuffer stocke des octets auxquels différents agents JavaScript peuvent accéder. Les vues interprètent ces octets, tandis qu’Atomics aide à coordonner les opérations concurrentes.

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

Syntaxe

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

SharedArrayBuffer représente un bloc de mémoire binaire partagée, et non un tableau de nombres. Son constructeur doit être appelé avec new ; la longueur est exprimée en octets, initialement remplis de zéros. La lecture et l’écriture se font au moyen de vues comme Int32Array ou DataView. Contrairement à ArrayBuffer, ce tampon ne peut pas être détaché.

Le partage ne garantit pas à lui seul la synchronisation. Des opérations comme view[0]++ ne sont pas des incréments atomiques : des mises à jour concurrentes peuvent être perdues. Utilisez Atomics sur les vues entières prises en charge et adoptez un protocole de communication réfléchi ; plusieurs appels atomiques ne constituent pas automatiquement une transaction unique.

Sans option, le tampon a une longueur fixe. L’option { maxByteLength } permet de créer un tampon qui peut être agrandi avec grow(newByteLength), mais pas réduit. byteLength correspond à la taille actuelle ; maxByteLength est la limite.

La disponibilité dépend de l’environnement hôte : la spécification permet que le constructeur ne soit pas fourni. ECMAScript seul n’établit ni la prise en charge dans un navigateur donné ni ses exigences de sécurité ; une exécution dans Node ne le prouve pas non plus. L’exemple vérifie la disponibilité et utilise deux vues du même tampon sans lancer d’agents concurrents.

Exemples

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

Résultat

4 10 15

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources