Array.prototype.length

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

Property attributes of Array.prototype.length
Writable yes
Enumerable no
Configurable no

Syntax

arr.length

Beschreibung

Die length Eigenschaft ist ein positiver Integer Wert < 232.

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

Spezifikation Status Komment
ECMAScript 1st Edition (ECMA-262) Standard Initiale Definition.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Array.length' in dieser Spezifikation.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Array.length' in dieser Spezifikation.
Standard  
ECMAScript 2017 Draft (ECMA-262)
Die Definition von 'Array.length' in dieser Spezifikation.
Entwurf  

Browserkompabilität

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Ja) (Ja) (Ja) (Ja) (Ja)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Ja) (Ja) (Ja) (Ja) (Ja) (Ja)

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
 Mitwirkende an dieser Seite: schlagi123, AndyTheDandy
 Zuletzt aktualisiert von: schlagi123,