ArrayBuffer.prototype.maxByteLength
Baseline
2024
Neu verfügbar
Seit July 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die Zugriffsproperty maxByteLength von ArrayBuffer-Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser Array-Buffer 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-Property ist eine Zugriffsproperty, deren Set-Zugriffs-Funktion undefined ist, was bedeutet, dass Sie diese Property nur lesen können. Der Wert wird bei der Konstruktion des Arrays festgelegt, wobei die maxByteLength-Option des ArrayBuffer()-Konstruktors verwendet wird und nicht geändert werden kann.
Diese Property gibt 0 zurück, wenn dieses ArrayBuffer getrennt wurde. Wenn dieses ArrayBuffer ohne Angabe eines maxByteLength-Werts konstruiert wurde, gibt diese Property einen Wert zurück, der dem Wert der byteLength des ArrayBuffer entspricht.
Beispiele
Verwendung von maxByteLength
In diesem Beispiel erstellen wir einen 8-Byte-Buffer, 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
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-get-arraybuffer.prototype.maxbytelength |