ArrayBuffer.prototype.maxByteLength
Baseline 2024Newly 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 Eigenschaft maxByteLength der Zugriffs-Property von ArrayBuffer-Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser Array-Puffer vergrößert werden kann.
Probieren Sie es aus
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
console.log(buffer.byteLength);
// Expected output: 8
console.log(buffer.maxByteLength);
// Expected output: 16
Beschreibung
Die maxByteLength-Eigenschaft ist eine Zugriffs-Property, deren Set-Accessor-Funktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird beim Erstellen des Arrays festgelegt, über die maxByteLength-Option des ArrayBuffer()-Konstruktors gesetzt und kann nicht geändert werden.
Diese Eigenschaft gibt 0 zurück, wenn dieser ArrayBuffer getrennt wurde. Wenn dieser ArrayBuffer ohne Angabe eines maxByteLength-Wertes erstellt wurde, gibt diese Eigenschaft einen Wert zurück, der dem Wert des byteLength des ArrayBuffer 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 dessen maxByteLength zurück:
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
buffer.maxByteLength; // 16
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-get-arraybuffer.prototype.maxbytelength |