Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

SharedArrayBuffer — współdzielona pamięć binarna

SharedArrayBuffer przechowuje bajty, do których mogą mieć dostęp różni agenci JavaScript. Widoki interpretują te bajty, a Atomics pomaga koordynować współbieżne operacje.

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

Składnia

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

SharedArrayBuffer reprezentuje blok współdzielonej pamięci binarnej, a nie tablicę liczb. Konstruktor wymaga new; długość podaje się w bajtach, początkowo wyzerowanych. Do odczytu i zapisu służą widoki, np. Int32Array lub DataView. W odróżnieniu od ArrayBuffer bufor ten nie może zostać odłączony.

Samo współdzielenie nie zapewnia synchronizacji. Operacje takie jak view[0]++ nie są atomowym zwiększeniem: współbieżne aktualizacje mogą się zgubić. Używaj Atomics na obsługiwanych widokach całkowitoliczbowych oraz przemyślanego protokołu komunikacji; kilka wywołań atomowych nie tworzy automatycznie jednej transakcji.

Bez opcji bufor ma stałą długość. Opcja { maxByteLength } pozwala utworzyć bufor powiększalny przez grow(newByteLength), lecz nie zmniejszalny. byteLength oznacza bieżący rozmiar, a maxByteLength limit.

Dostępność zależy od środowiska: specyfikacja pozwala nie udostępniać konstruktora. Sam standard ECMAScript nie potwierdza obsługi w konkretnej przeglądarce ani jej wymagań bezpieczeństwa; uruchomienie w Node również tego nie dowodzi. Przykład sprawdza dostępność i używa dwóch widoków tego samego bufora bez uruchamiania współbieżnych agentów.

Przykłady

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

Wynik

4 10 15

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła