Array: length

Probieren Sie es aus

const clothing = ["shoes", "shirts", "socks", "sweaters"];

console.log(clothing.length);
// Expected output: 4

Wert

Eine nichtnegative ganze Zahl kleiner als 232.

Beschreibung

Der Wert der length-Eigenschaft ist eine nichtnegative ganze Zahl mit einem Wert kleiner als 232.

const listA = [1, 2, 3];
const listB = new Array(6);

console.log(listA.length);
// 3

console.log(listB.length);
// 6

listB.length = 2 ** 32; // 4294967296
// RangeError: Invalid array length

const listC = new Array(-100); // Negative numbers are not allowed
// RangeError: Invalid array length

Das Array-Objekt beobachtet die length-Eigenschaft und synchronisiert den length-Wert automatisch mit dem Inhalt des Arrays. Das bedeutet:

• Wenn length auf einen Wert gesetzt wird, der kleiner ist als die aktuelle Lnge, wird das Array gekrzt Elemente, die ber die neue length hinausgehen, werden gelscht.
• Wenn ein Array-Index (eine nichtnegative ganze Zahl, die kleiner als 232 ist) jenseits der aktuellen length gesetzt wird, wird das Array erweitert die length-Eigenschaft wird erhht, um den neuen hchsten Index widerzuspiegeln.
• Wenn length auf einen ungltigen Wert (z. B. eine negative Zahl oder eine Nicht-Ganzzahl) gesetzt wird, wird eine RangeError-Ausnahme ausgelst.

Wenn length auf einen greren Wert als die aktuelle Lnge gesetzt wird, wird das Array durch Hinzufgen von leeren Pltzen und nicht durch tatschliche undefined Werte erweitert. Leere Pltze haben einige spezielle Interaktionen mit Array-Methoden; siehe Array-Methoden und leere Slots.

const arr = [1, 2];
console.log(arr);
// [ 1, 2 ]

arr.length = 5; // set array length to 5 while currently 2.
console.log(arr);
// [ 1, 2, <3 empty items> ]

arr.forEach((element) => console.log(element));
// 1
// 2

Siehe auch Beziehung zwischen length und numerischen Eigenschaften.

Beispiele

ber ein Array iterieren

Im folgenden Beispiel wird das Array numbers durch Iteration ber die length-Eigenschaft durchlaufen. Der Wert jedes Elements wird dann verdoppelt.

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

Ein Array verkrzen

Das folgende Beispiel verkrzt das Array numbers auf eine Lnge von 3, wenn die aktuelle Lnge grer als 3 ist.

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

if (numbers.length > 3) {
  numbers.length = 3;
}

console.log(numbers); // [1, 2, 3]
console.log(numbers.length); // 3
console.log(numbers[3]); // undefined; the extra elements are deleted

Leeres Array mit fester Lnge erstellen

Das Setzen von length auf einen Wert, der grer ist als die aktuelle Lnge, erzeugt ein sprliches Array.

const numbers = [];
numbers.length = 3;
console.log(numbers); // [empty x 3]

Array mit nicht-schreibbarer Lnge

Die length-Eigenschaft wird vom Array automatisch aktualisiert, wenn Elemente ber die aktuelle Lnge hinaus hinzugefgt werden. Wenn die length-Eigenschaft schreibgeschtzt gemacht wird, kann das Array sie nicht aktualisieren. Dies fhrt zu einem Fehler im Strict-Modus.

"use strict";

const numbers = [1, 2, 3, 4, 5];
Object.defineProperty(numbers, "length", { writable: false });
numbers[5] = 6; // TypeError: Cannot assign to read only property 'length' of object '[object Array]'
numbers.push(5); // // TypeError: Cannot assign to read only property 'length' of object '[object Array]'

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Leitfaden zu Indexierte Sammlungen
• Array
• TypedArray.prototype.length
• String: length
• RangeError: ungltige Array-Lnge