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 maxByteLength Zugriffseigenschaft von ArrayBuffer Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser ArrayBuffer 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 Zugriffseigenschaft, deren Set-Accessor-Funktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird bei der Konstruktion des Array gesetzt, über die maxByteLength-Option des ArrayBuffer() Konstruktors festgelegt 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 konstruiert wurde, gibt diese Eigenschaft einen Wert zurück, der dem Wert der 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® 2025 Language Specification # sec-get-arraybuffer.prototype.maxbytelength |