Array.prototype.length

Die length Eigenschaft repräsentiert einen unsigned, 32-bit Integer Wert, der die Anzahl der Elemente in einem Array angibt.

Syntax

arr.length

Beschreibung

Die length Eigenschaft ist ein positiver Integer Wert < 2^32.

Mit der manipulation der length Eigenschaft kann ein Array zu jeder Zeit gekürzt werden. Bei Erweiterung eines Arrays duch Änderung der length Eigenschaft wird nicht zugleich die Anzahl der darin enthaltenen Elemente erhöht.  Wenn z.B. length auf 3 gesetzt wird, obwohl nur 2 Werte enthalten sind, enthält das Array trotzdem nur 2 Werte. So sagt die length Eigenschaft nichts über die Anzahl der definierten Werte im Array aus. Siehe auch Relationship between length and numerical properties.

Beispiele

Iterieren über ein Array

Im folgenden Beispiel wird über das numbers Array iteriert indem dafür die length Eigenschaft verwendet wird, um nachzusehen, wie viele Elemnte das Array beinhaltet. Der Wert jedes Elements wird verdoppelt.

var numbers = [1, 2, 3, 4, 5];

for (var i = 0; i < numbers.length; i++) {
  numbers[i] *= 2;
}
// numbers is now [2, 4, 6, 8, 10]

Verkürzung eines Arrays

Das folgende Beispiel verkürzt das Array statesUS zu einer Länge von 50, wenn die Länge größer 50 beträgt.

if (statesUS.length > 50) {
  statesUS.length = 50;
}

Spezifikationen

Browserkompabilität

Siehe auch

• Array