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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
maxByteLength

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch