WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

TypedArray.length — Anzahl der Elemente einer Ansicht

TypedArray.length gibt die Anzahl der Elemente in einem typisierten Array an, nicht die Anzahl der Bytes. Lies den Wert an einer Instanz aus, zum Beispiel mit values.length; damit lässt sich die Ansicht nicht vergrößern oder verkleinern.

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

typedArray.length

TypedArray.length bezeichnet hier die Instanzeigenschaft, die als TypedArray.prototype.length dokumentiert ist. Lies sie mit typedArray.length aus, also ohne Aufrufklammern. TypedArray ist die gemeinsame Abstraktion für konkrete Typen wie Uint16Array und kein globaler Konstruktor, der direkt verwendet werden kann.

length zählt die Elemente der Ansicht. byteLength zählt die Bytes dieser Ansicht, während buffer.byteLength den gesamten Puffer beschreibt. Jedes Element eines Uint16Array belegt 2 Bytes. Eine Ansicht mit einer length von 3 hat daher eine byteLength von 6. Eine Ansicht kann nur einen Teil ihres Puffers abdecken. Beim Konstruktor wird byteOffset in Bytes und length in Elementen angegeben.

Die Eigenschaft ist ein Accessor ohne Setter: Eine Zuweisung an length ändert die Größe eines typisierten Arrays nicht. Bei einem größenveränderlichen Puffer kann sich die length einer längenverfolgenden Ansicht jedoch mit der Größe des Puffers ändern. Wird durch das Verkleinern des Puffers der Bereich der Ansicht ungültig, gibt das Auslesen der Eigenschaft 0 zurück, auch bei einer Ansicht mit fester Länge. Prüfe die Unterstützung größenveränderlicher Puffer gesondert; der Zugriff auf length allein belegt diese Unterstützung nicht.

Beispiele

const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);

console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);

Ergebnis

3
6
12

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.

Quellen