SharedArrayBuffer() Konstruktor

Probieren Sie es aus

// Create a SharedArrayBuffer with a size in bytes
const buffer = new SharedArrayBuffer(8);

console.log(buffer.byteLength);
// Expected output: 8

Syntax

new SharedArrayBuffer(length)
new SharedArrayBuffer(length, options)

Parameter

length

Die Größe des zu erstellenden Array-Puffers in Byte.

options Optional

Ein Objekt, das die folgenden Eigenschaften enthalten kann:

maxByteLength Optional

Die maximale Größe in Byte, auf die der shared array buffer vergrößert werden kann.

Rückgabewert

Ein neues SharedArrayBuffer Objekt der angegebenen Größe, mit der maxByteLength-Eigenschaft auf den angegebenen maxByteLength gesetzt, falls einer angegeben wurde. Der Inhalt wird auf 0 initialisiert.

Beispiele

Verwenden Sie immer den new-Operator, um einen SharedArrayBuffer zu erstellen

SharedArrayBuffer Konstruktoren müssen mit einem new Operator konstruiert werden. Der Aufruf eines SharedArrayBuffer Konstruktors als Funktion ohne new führt zu einem TypeError.

const sab = SharedArrayBuffer(1024);
// TypeError: calling a builtin SharedArrayBuffer constructor
// without new is forbidden

const sab = new SharedArrayBuffer(1024);

Wachstum eines wachstumsfähigen SharedArrayBuffer

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes wachsen kann, und vergrößern ihn dann mit grow() auf 12 Bytes:

const buffer = new SharedArrayBuffer(8, { maxByteLength: 16 });

buffer.grow(12);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Atomics
• ArrayBuffer
• Leitfaden zu JavaScript getypten Arrays