ArrayBuffer.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 ArrayBuffer-Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser ArrayBuffer geändert 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-Eigenschaft, deren set-Zugriffs-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-Werts erstellt wurde, gibt diese Eigenschaft einen Wert zurück, der dem Wert der byteLength-Eigenschaft 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 geändert werden kann, und geben dann seine maxByteLength zurück:

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

buffer.maxByteLength; // 16

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-get-arraybuffer.prototype.maxbytelength

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch