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

Beschreibung

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

Wenn dieser SharedArrayBuffer ohne Angabe eines maxByteLength-Werts erstellt wurde, gibt diese Eigenschaft 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 erweiterbar ist, und geben dann seine maxByteLength zurück:

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

buffer.maxByteLength; // 16

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch