WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array-Länge: Array.length

Die Eigenschaft length gibt die Länge eines Arrays an, aber nicht unbedingt die Anzahl seiner vorhandenen Elemente. Eine Zuweisung kann Elemente löschen oder die Länge erhöhen, ohne die neuen Positionen zu füllen.

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

array.length
array.length = newLength

Array.length bezeichnet hier die Eigenschaft length einer Array-Instanz, die als array.length gelesen wird, nicht die Eigenschaft des Array-Konstruktors. Sie ist eine Eigenschaft, keine Methode. Ihr Wert ist eine ganze Zahl von 0 bis einschließlich 2 ** 32 - 1.

Die Länge zählt nicht die vorhandenen Elemente: Ein Array kann leere Stellen enthalten. Erzeugt eine Zuweisung ein Element an einem Array-Index, der größer oder gleich der aktuellen Länge ist, erhöht sich length auf diesen Index plus eins. Ist length nicht mehr beschreibbar, fügt eine solche Zuweisung kein Element hinzu und verlängert das Array nicht: Im Strict Mode löst sie einen TypeError aus, andernfalls schlägt sie ohne Fehlermeldung fehl. delete array[i] entfernt das Element, wenn es eine eigene, konfigurierbare Eigenschaft des Arrays ist, verringert aber nicht die Länge. Ist die eigene Eigenschaft an diesem Index nicht konfigurierbar, bleibt sie erhalten: Außerhalb des Strict Mode gibt delete false zurück, im Strict Mode löst es einen TypeError aus.

Wird eine kleinere Länge zugewiesen, werden eigene Elemente gelöscht, deren Indizes größer oder gleich der neuen Länge sind. Eine Erhöhung der Länge erzeugt keine Elemente mit dem Wert undefined, sondern lässt leere Stellen zurück. Im Beispiel setzt die Zuweisung an Index 4 die Länge auf 5; die spätere Verkürzung auf 2 entfernt dieses Element.

Wird bei einer Zuweisung an array.length die neue Länge geprüft, löst eine negative Zahl, ein nicht ganzzahliger Bruch, NaN, Infinity oder 2 ** 32 einen RangeError aus. Ist length nicht beschreibbar, wird die Zuweisung ohne Prüfung der neuen Länge abgewiesen: Im Strict Mode löst sie einen TypeError aus, andernfalls schlägt sie ohne Fehlermeldung fehl. Anfangs ist length beschreibbar, nicht aufzählbar und nicht konfigurierbar. Ein nicht konfigurierbares Element kann das Kürzen blockieren: Die Länge bleibt bei dessen Index plus eins stehen. Im Strict Mode löst diese Zuweisung einen TypeError aus; Elemente mit höheren Indizes können bereits gelöscht worden sein.

Beispiele

const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));

Ergebnis

5
false
[10,20]
4
false

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