ArrayBuffer.prototype.resize()

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 resize()-Methode von ArrayBuffer-Instanzen ändert die Größe des ArrayBuffer auf die angegebene Größe in Bytes.

In diesem Artikel

Probieren Sie es aus

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

console.log(buffer.byteLength);
// Expected output: 8

buffer.resize(12);

console.log(buffer.byteLength);
// Expected output: 12

Syntax

resize(newLength)

Parameter

newLength

Die neue Länge in Bytes, auf die der ArrayBuffer geändert werden soll.

Ausnahmen

TypeError

Wird ausgelöst, wenn der ArrayBuffer getrennt ist oder nicht veränderbar ist.

RangeError

Wird ausgelöst, wenn newLength größer ist als die maxByteLength des ArrayBuffer.

Die resize()-Methode ändert die Größe eines ArrayBuffer auf die durch den Parameter newLength angegebene Größe, vorausgesetzt, der ArrayBuffer ist veränderbar und die neue Größe ist kleiner oder gleich der maxByteLength des ArrayBuffer. Neue Bytes werden auf 0 initialisiert.

Beachten Sie, dass Sie resize() verwenden können, um einen ArrayBuffer sowohl zu verkleinern als auch zu vergrößern – es ist zulässig, dass newLength kleiner als die aktuelle byteLength des ArrayBuffer ist.

Beispiele

Verwenden von resize()

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes veränderbar ist. Dann prüfen wir seine resizable-Eigenschaft und ändern die Größe, wenn resizable true zurückgibt:

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

if (buffer.resizable) {
  console.log("Buffer is resizable!");
  buffer.resize(12);
}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
ArrayBuffer
Konstruktor
1. ArrayBuffer()
Statische Methoden
1. isView()
Statische Eigenschaften
1. [Symbol.species]
Instanzmethoden
Instanzeigenschaften
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor

ArrayBuffer.prototype.resize()

In diesem Artikel

Probieren Sie es aus

Syntax

Parameter

Rückgabewert

Ausnahmen

Beschreibung

Beispiele

Verwenden von resize()

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN