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 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-get-arraybuffer.prototype.maxbytelength |