SharedArrayBuffer.prototype.maxByteLength

Baseline 2024
Newly available

Since July 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die maxByteLength Zugriffs-Eigenschaft von SharedArrayBuffer Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser SharedArrayBuffer erweitert werden kann.

Beschreibung

Die maxByteLength Eigenschaft ist eine Zugriffseigenschaft, deren Set-Accessor-Funktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird festgelegt, wenn das Shared-Array erstellt wird. Dies geschieht über die maxByteLength Option des SharedArrayBuffer() Konstruktors und kann nicht geändert werden.

Wenn dieser SharedArrayBuffer ohne Angabe eines maxByteLength Werts erstellt wurde, liefert diese Eigenschaft einen Wert, der dem Wert der byteLength des SharedArrayBuffer entspricht.

Beispiele

Verwendung von maxByteLength

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes erweiterbar ist, und geben dann dessen maxByteLength zurück:

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

buffer.maxByteLength; // 16

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-get-sharedarraybuffer.prototype.maxbytelength

Browser-Kompatibilität

Siehe auch