SharedArrayBuffer() Konstruktor

Syntax

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

Parameter

length

Die Größe, in Bytes, des zu erstellenden Array-Buffers.

options Optional

Ein Objekt, das die folgenden Eigenschaften enthalten kann:

maxByteLength Optional

Die maximale Größe, in Bytes, 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 ist auf 0 initialisiert.

Beispiele

Beachten Sie, dass diese Beispiele nicht direkt in der Konsole oder auf einer beliebigen Webseite ausgeführt werden können, da SharedArrayBuffer nicht definiert ist, es sei denn, seine Sicherheitsvoraussetzungen sind erfüllt.

Grundlegende Nutzung

Erstellen Sie einen Buffer, indem Sie seine Größe in Bytes angeben.

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

console.log(buffer.byteLength); // 8

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

SharedArrayBuffer Konstruktoren müssen mit einem new Operator konstruiert werden. Das Aufrufen 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 vergrößerbaren SharedArrayBuffer

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

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

buffer.grow(12);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Atomics
• ArrayBuffer
• JavaScript typisierte Arrays Leitfaden