Array: length

Eine nicht negative Ganzzahl kleiner als 2³².

Der Wert der length-Eigenschaft ist eine nicht negative Ganzzahl mit einem Wert kleiner als 2³².

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 kleiner als die aktuelle Länge gesetzt wird, wird das Array gekürzt – Elemente jenseits der neuen length werden gelöscht.
• Wenn ein Array-Index (eine nicht negative Ganzzahl kleiner als 2³²) jenseits der aktuellen length gesetzt wird, wird das Array erweitert – die length-Eigenschaft wird erhöht, um den neuen höchsten Index widerzuspiegeln.
• Wenn length auf einen ungültigen Wert gesetzt wird (z. B. eine negative Zahl oder keine Ganzzahl), wird eine RangeError-Ausnahme ausgelöst.

Wenn length auf einen größeren Wert als die aktuelle Länge gesetzt wird, wird das Array durch Hinzufügen von leeren Slots und nicht tatsächlichen undefined-Werten erweitert. Leere Slots haben 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.

Im folgenden Beispiel wird das Array numbers durchlaufen, indem die length-Eigenschaft betrachtet wird. 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]

Im folgenden Beispiel wird das Array numbers auf eine Länge von 3 verkürzt, wenn die aktuelle Länge größer 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

Das Setzen von length auf einen Wert, der größer als die aktuelle Länge ist, erstellt ein dünn besetztes Array.

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

Die length-Eigenschaft wird vom Array automatisch aktualisiert, wenn Elemente jenseits der aktuellen Länge hinzugefügt werden. Wenn die length-Eigenschaft nicht änderbar gemacht wird, kann das Array sie nicht aktualisieren. Dies führt 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]'

• Indizierte Sammlungen Leitfaden
• Array
• TypedArray.prototype.length
• String: length
• RangeError: ungültige Array-Länge