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-Property von SharedArrayBuffer-Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser SharedArrayBuffer wachsen kann.

Beschreibung

Die maxByteLength-Property ist eine Zugriffs-Property, deren set-Zugriffsfunktions-Property undefined ist, was bedeutet, dass Sie diese Property nur lesen können. Der Wert wird festgelegt, wenn das gemeinsame Array erstellt wird, indem die maxByteLength-Option des SharedArrayBuffer()-Konstruktors gesetzt wird und kann nicht geändert werden.

Wenn dieser SharedArrayBuffer erstellt wurde, ohne einen maxByteLength-Wert anzugeben, gibt diese Property einen Wert zurück, der dem Wert des 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 vergrößert werden kann, und geben dann seinen 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