CKTIS / JavaScript
Länge und Indizierung typisierter Arrays
`length` zählt die Elemente einer Ansicht, nicht ihre Bytes. Die Indizierung beginnt bei null; ein Schreibzugriff hinter dem Ende vergrößert die Ansicht nicht.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Ein typisiertes Array wie Uint16Array ist eine Ansicht auf einen Puffer. view.length ist eine geerbte Eigenschaft mit Getter, aber ohne Setter. Sie zählt Elemente; view.byteLength zählt die Bytes der Ansicht und view.buffer.byteLength die Bytes des gesamten Puffers. Eine Zuweisung an view.length ändert die Größe der Ansicht nicht und löst im Strict Mode einen TypeError aus.
Elementindizes sind ganze Zahlen von 0 bis view.length - 1. view[0] und view["0"] bezeichnen dasselbe Element. Schlüssel wie "01" und "1.0" sind gewöhnliche Eigenschaftsnamen, keine Elementindizes. view[-0] verhält sich wie view[0], aber view["-0"] ergibt undefined.
Das Lesen an einem ungültigen Elementindex ergibt undefined. Ein Schreibzugriff ändert dort weder den Puffer noch fügt er ein Element hinzu, auch im Strict Mode, sofern die Wertkonvertierung gelingt. Die Konvertierung kann dennoch einen Fehler auslösen, etwa beim Schreiben eines Number-Werts in ein BigInt64Array. Bei gültigem Index wird der Wert entsprechend dem Elementtyp gespeichert. view[-1] zählt nicht vom Ende; view.at(-1) dagegen liefert bei einer nicht leeren Ansicht das letzte Element.
Erhält der Konstruktor einen größenveränderlichen ArrayBuffer oder einen vergrößerbaren SharedArrayBuffer, passt sich die Länge der Ansicht ohne das dritte Argument length (oder mit undefined) an die Anzahl vollständiger Elemente ab byteOffset bis zum aktuellen Pufferende an. Bei einem Puffer fester Größe erzeugt derselbe Aufruf eine Ansicht fester Länge. Dabei muss die Anzahl der Bytes ab byteOffset bis zum Pufferende ein Vielfaches der Elementgröße in Bytes sein; andernfalls löst der Konstruktor einen RangeError aus. Eine explizite Länge legt die Elementanzahl fest, solange die Ansicht in den Puffer passt. Passt sie nach dem Verkleinern nicht mehr hinein, ergibt length den Wert 0; erneutes Vergrößern kann die Ansicht wieder in den gültigen Bereich bringen. Auch das Abtrennen des Puffers führt zu length === 0. In beiden Fällen ergibt ein indizierter Lesezugriff undefined, während at() einen TypeError auslöst.
Beispiele
"use strict";
{
const view = new Uint16Array([10, 20]);
view[1] = 65537;
view[view.length] = 99;
console.log(`${view.length} ${view.byteLength}`);
console.log(`${view[0]} ${view[1]}`);
console.log(`${view[view.length]} ${view[-1]} ${view.at(-1)}`);
}Ergebnis
2 4 10 1 undefined undefined 1
Zwei `Uint16Array`-Elemente belegen vier Bytes. Aus `65537` wird beim Speichern `1`, weil nur die niederwertigen 16 Bits erhalten bleiben. Ein Schreibzugriff bei Index `2` vergrößert die Ansicht nicht; `at(-1)` liest das letzte Element.
Zugehörige Lektionen
- JavaScript · Lektion 33 · Fortgeschritten · Version: 4
- JavaScript · Lektion 34 · Fortgeschritten · Version: 4