WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Länge und Indizierung von Arrays in JavaScript

`length` bestimmt den Positionsbereich eines Arrays, nicht die Anzahl vorhandener Elemente. Ein Schreibzugriff per Index kann das Array verlängern; eine Kürzung kann Elemente löschen.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

a.length
 a[i]
 a[i] = value
 a.length = newLength
 delete a[i]
 Object.hasOwn(a, i)
 a.at(-1)

a.length ist eine eigene Dateneigenschaft einer Array-Instanz, keine Methode und keine statische Eigenschaft. Die Indizierung beginnt bei 0. Bei einer Länge größer als null ist a.length - 1 die letzte Position; sie kann leer sein. Die Länge reicht von 0 bis 2 ** 32 - 1; der größte Arrayindex ist 2 ** 32 - 2.

a[1] und a["1"] greifen auf denselben Eigenschaftsschlüssel zu. a["01"], a[-1] und a[2 ** 32 - 1] verwenden Schlüssel, die keine Arrayindizes sind. Schreibzugriffe darauf ändern die Länge nicht. Dagegen liest a.at(-1) die letzte Position relativ zur Länge und gibt bei Länge null undefined zurück.

Erzeugt ein Schreibzugriff ein eigenes Element bei i >= a.length, wächst die Länge auf i + 1; übersprungene Positionen bleiben leer. Eine Lücke ist kein eigenes Element mit dem Wert undefined: Ein Lesezugriff mit Klammern kann eine geerbte Eigenschaft finden und liefert undefined, wenn keine passende Eigenschaft existiert. Object.hasOwn(a, i) prüft auf eine eigene Eigenschaft; i in a berücksichtigt auch die Prototypenkette.

Eine Vergrößerung von length erzeugt keine Elemente. Eine Verkleinerung löscht eigene Elemente mit Indizes ab der neuen Länge, beginnend beim größten Index. Erneutes Verlängern stellt sie nicht wieder her. Ein erfolgreiches delete a[i] verkürzt das Array nicht.

Die Zuweisung einer Zahl außerhalb des erlaubten Bereichs oder einer nicht ganzzahligen Zahl an eine schreibbare length löst RangeError aus. Ein nicht konfigurierbares Element kann die Kürzung blockieren: Die Länge bleibt bei dessen Index plus eins, und vorherige Löschungen werden nicht rückgängig gemacht. Im Strict Mode löst diese fehlgeschlagene Zuweisung TypeError aus; sonst kann sie ohne Fehlermeldung scheitern.

Beispiele

{
  const a = ["A", undefined];
  a[3] = "D";
  console.log(`${a.length} ${a[1]} ${a[2]}`);
  console.log(`${Object.hasOwn(a, 1)} ${Object.hasOwn(a, 2)}`);

  a[-1] = "label";
  console.log(`${a[-1]} ${a.at(-1)} ${a.length}`);

  a.length = 2;
  a.length = 4;
  console.log(`${a.length} ${Object.hasOwn(a, 3)} ${a[-1]}`);
}

Ergebnis

4 undefined undefined
true false
label D 4
4 false label

Beim Lesen liefern `1` und `2` jeweils `undefined`, aber nur `1` ist ein eigenes Element. Der Schlüssel `-1` enthält `label`, `a.at(-1)` liefert dagegen `D`. Die Kürzung löscht `D`; erneutes Verlängern stellt es nicht wieder her und lässt die Eigenschaft `-1` unverändert.

Zugehörige Lektionen

  • JavaScript · Lektion 28 · Fortgeschritten · Version: 4

Quellen