WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ArrayBuffer: Puffer für Rohbytes

ArrayBuffer reserviert nullgefüllten Bytespeicher, der über Typed Array oder DataView gelesen wird und optional größenänderbar sein kann.

Version: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2

Syntax

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) erzeugt einen mit Nullen gefüllten Speicherblock. Ein ArrayBuffer selbst bietet keine indizierten Bytes; zum Lesen und Schreiben ist eine Ansicht wie Uint8Array oder DataView nötig. byteLength durchläuft ToIndex: Ein endlicher Bruchteil wird gegen null abgeschnitten, NaN und undefined werden 0, und selbst -0.5 wird zu -0 und damit zur Länge 0. Ein Aufruf ohne new löst TypeError aus.

options.maxByteLength fordert einen größenänderbaren Puffer an, wenn das Limit nicht kleiner als der Anfangswert ist. resize(newLength) bewahrt das gemeinsame Präfix, verwirft Bytes beim Verkleinern und ergänzt Nullen beim Vergrößern; längenverfolgende Ansichten passen sich an. Ein fester Puffer ist nicht änderbar. slice() kopiert einen Bereich, Transfer kann die Quelle ablösen.

Erst ein negatives Ergebnis nach ToIntegerOrInfinity, +Infinity oder -Infinity, das Überschreiten des Zahlenbereichs oder praktischen Speicherlimits der Implementierung sowie ein Maximum unter der Anfangsgröße ergibt RangeError. Datenoperationen auf einem abgelösten Puffer und resize() auf einem festen Puffer ergeben TypeError. Konvertierungsfehler werden weitergegeben. Größenänderbare ArrayBuffer und Transfer wurden in ECMAScript 2024 standardisiert.

Die Bereichsbezeichnung ArrayBuffer.byteLength meint die Instanzeigenschaft, die als buffer.byteLength verwendet wird, nicht eine statische Eigenschaft des Konstruktors ArrayBuffer. Dieser schreibgeschützte Accessor liefert die aktuelle Bytezahl: Nach resize() eines größenänderbaren Puffers ändert sich das Ergebnis, nach dem Ablösen ist es 0. Ein Setter fehlt; wird der Getter auf einen inkompatiblen Receiver einschließlich SharedArrayBuffer angewandt, entsteht TypeError.

Beispiele

const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);

buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));

const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));

try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }

Ergebnis

4 8 true
6 10,20,30,40,0,0
3 20,30,40
true

Quellen