CKTIS / JavaScript
Typisierte Arrays: Elementanzahl, Bytes der Ansicht und Puffergröße
Unterscheide das Pufferobjekt (`.buffer`), die Anzahl der Elemente (`.length`), die Bytes der Ansicht (`.byteLength`) und die aktuelle Byteanzahl des gesamten Puffers (`.buffer.byteLength`).
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer // backing buffer object
view.length // element count in the view
view.byteLength // byte count in the view
buffer.byteLength // current byte count of the entire bufferview.buffer gibt ohne Kopie dasselbe Pufferobjekt zurück: einen ArrayBuffer oder bei einer Ansicht auf gemeinsamen Speicher einen SharedArrayBuffer. view.length zählt Elemente, view.byteLength dagegen die Bytes der Ansicht: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength liefert die aktuelle Byteanzahl des gesamten Puffers, nicht dessen Maximum. SharedArrayBuffer hat einen eigenen Getter für byteLength. Das sind schreibgeschützte Eigenschaften, keine Methoden.
new Uint16Array(n) reserviert Speicher für n Elemente. Dagegen erstellt new Uint16Array(buffer, byteOffset, length) eine Ansicht ohne Kopie: Der Offset wird in Bytes, die Länge in Elementen angegeben. Ein falsch ausgerichteter Offset oder ein Bereich jenseits der Puffergrenzen führt zu RangeError. Soll der Empfänger nur die Daten der Ansicht erhalten, übergib eine Kopie ihres Bytebereichs, nicht view.buffer, denn darüber sind auch Bytes außerhalb der Ansicht zugänglich.
Bei einem größenveränderlichen ArrayBuffer (ECMAScript 2024) umfasst die Ansicht ohne length jeweils so viele vollständige Elemente, wie vom Offset bis zum Pufferende passen. Ein explizites length legt den Bereich fest. Beim Verkleinern kann die Ansicht außerhalb der Puffergrenzen geraten: view.length und view.byteLength liefern dann 0. Erneutes Vergrößern kann den Bereich wieder gültig machen. Prüfe vor der Verwendung, ob die Zielumgebung Größenänderungen unterstützt.
Beim Transfer eines ArrayBuffer auf der Webplattform kann der ursprüngliche Puffer vom Speicher getrennt werden. view.buffer liefert weiterhin dasselbe Objekt, doch buffer.byteLength, view.length und view.byteLength liefern 0. Null allein beweist keine Trennung: Ein Puffer oder eine Ansicht kann einfach leer sein.
Beispiele
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}Ergebnis
true | 3 | 6 | 16
`true | 3 | 6 | 16` bestätigt, dass die Ansicht denselben Puffer verwendet: Ab Byteoffset 4 umfasst sie 3 Elemente zu je 2 Bytes in einem 16-Byte-Puffer.
Zugehörige Lektionen
- JavaScript · Lektion 5 · Fortgeschritten · Version: 4
Quellen
- ECMAScript 2024 — get %TypedArray%.prototype.buffer
- ECMAScript 2024 — get %TypedArray%.prototype.length
- ECMAScript 2024 — get %TypedArray%.prototype.byteLength
- ECMAScript 2024 — get ArrayBuffer.prototype.byteLength
- ECMAScript 2024 — get SharedArrayBuffer.prototype.byteLength
- ECMAScript 2024 — InitializeTypedArrayFromArrayBuffer
- ECMAScript 2024 — ArrayBuffer.prototype.resize
- MDN — TypedArray: Behavior when viewing a resizable buffer
- HTML Standard — StructuredSerializeWithTransfer