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 vergrößert werden kann.
Beschreibung
Die maxByteLength Eigenschaft ist eine Zugriffs-Eigenschaft, deren Set-Accessor-Funktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird bei der Konstruktion des Shared-Arrays festgelegt, über die maxByteLength-Option des SharedArrayBuffer() Konstruktors gesetzt und kann nicht geändert werden.
Wenn dieser SharedArrayBuffer ohne Angabe eines maxByteLength Wertes erstellt wurde, gibt diese Eigenschaft einen Wert zurück, der dem Wert des byteLength des SharedArrayBuffer entspricht.
Beispiele
Beachten Sie, dass diese Beispiele nicht direkt von der Konsole oder einer beliebigen Webseite ausgeführt werden können, da SharedArrayBuffer nicht definiert ist, es sei denn, die Sicherheitsanforderungen sind erfüllt.
Verwendung von maxByteLength
In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Byte vergrößerbar ist, und geben dann dessen maxByteLength zurück:
const buffer = new SharedArrayBuffer(8, { maxByteLength: 16 });
buffer.maxByteLength; // 16
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-get-sharedarraybuffer.prototype.maxbytelength |