CKTIS / JavaScript
TypedArray: Größen, Indizierung, Ansichten und Kopien
Lerne den Unterschied zwischen Elementanzahl und Byteanzahl bei TypedArray kennen. Erfahre, wie buffer und byteOffset eine Ansicht beschreiben und warum subarray() Daten gemeinsam nutzt, während slice() eine unabhängige Kopie erstellt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);TypedArray ist die gemeinsame Schnittstelle typisierter Ansichten auf Binärdaten, kein global verfügbarer Konstruktor. Verwende einen konkreten Typ wie Uint16Array. Diese APIs gehören zu ECMAScript und benötigen kein DOM. Hier bezeichnen TypedArray.length, TypedArray.byteLength, TypedArray.buffer und TypedArray.byteOffset Instanzeigenschaften wie view.length, keine statischen Eigenschaften.
length zählt Elemente, byteLength die Bytes der Ansicht, buffer verweist auf den gesamten zugrunde liegenden ArrayBuffer oder SharedArrayBuffer, und byteOffset gibt den Anfang der Ansicht in Bytes relativ zum Puffer an. Für eine gültige Ansicht gilt byteLength === length * BYTES_PER_ELEMENT. Eine Ansicht kann nur einen Teil ihres Puffers umfassen. In new Uint16Array(buffer, byteOffset, length) muss der Offset ein Vielfaches von 2 sein, während length weiterhin Elemente zählt. Diese Eigenschaften sind schreibgeschützt; durch eine Größenänderung des Puffers können sich die gemeldeten Größen dennoch ändern. Eine Ansicht außerhalb des gültigen Bereichs meldet Größen und Offset als null.
TypedArray.indexing bezeichnet die Syntax view[index], keine Methode. Indizes beginnen bei null und adressieren Elemente relativ zum Anfang der Ansicht. Bei einer Zuweisung wird der Wert in den Elementtyp umgewandelt. Ein Lesezugriff außerhalb des gültigen Bereichs gibt undefined zurück; ein Schreibzugriff außerhalb des Bereichs vergrößert die Ansicht nicht und speichert keinen Wert. view[-1] liest nicht das letzte Element.
TypedArray.prototype.subarray(begin, end) erstellt eine neue Ansicht, die den Puffer gemeinsam nutzt: Änderungen an überlappenden Elementen sind in beiden Ansichten sichtbar. TypedArray.prototype.slice(start, end) kopiert die ausgewählten Elemente in einen unabhängigen Puffer. Beide Methoden geben Grenzen in Elementen an, schließen den Anfang ein und das Ende aus; negative Grenzen zählen vom Ende aus, und ein ausgelassenes Ende bedeutet das Ende der Ansicht. Diese Regeln gelten für gewöhnliche integrierte Typen; benutzerdefinierte Unterklassen können die Erstellung der Ergebnisse über Symbol.species ändern.
Beispiele
const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);Ergebnis
4 8 2 12 4 true false 10,99,30,40 99,30 20,30 undefined 4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.