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 Zugriffseigenschaft von ArrayBuffer Instanzen gibt die maximale Länge (in Bytes) zurück, auf die dieser Array-Puffer geändert werden kann.

Probieren Sie es aus

Beschreibung

Die maxByteLength Eigenschaft ist eine Zugriffseigenschaft, deren set-Zugriffsfunktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird festgelegt, wenn der Array erstellt wird, durch die Option maxByteLength des ArrayBuffer() Konstruktors festgelegt und kann nicht geändert werden.

Diese Eigenschaft gibt 0 zurück, wenn dieser ArrayBuffer abgetrennt wurde. Wenn dieser ArrayBuffer erstellt wurde, ohne einen maxByteLength Wert anzugeben, gibt diese Eigenschaft einen Wert zurück, der dem Wert der byteLength des ArrayBuffer's 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 dessen maxByteLength zurück:

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

buffer.maxByteLength; // 16

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch