Array() Konstruktor

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Der Array() Konstruktor erstellt Array Objekte.

In diesem Artikel

Syntax

js
new Array()
new Array(element1)
new Array(element1, element2)
new Array(element1, element2, /* …, */ elementN)
new Array(arrayLength)

Array()
Array(element1)
Array(element1, element2)
Array(element1, element2, /* …, */ elementN)
Array(arrayLength)

Hinweis: Array() kann mit oder ohne new aufgerufen werden. Beides erstellt eine neue Array Instanz.

Ein JavaScript-Array wird mit den angegebenen Elementen initialisiert, außer im Fall, dass ein einzelnes Argument an den Array Konstruktor übergeben wird und dieses Argument eine Zahl ist (siehe den arrayLength Parameter unten). Beachten Sie, dass sich dieser Sonderfall nur auf mit dem Array Konstruktor erstellte JavaScript-Arrays bezieht, nicht auf mit der eckigen Klammer-Syntax erstellte Array-Literale.

arrayLength

Wenn das einzige Argument, das an den Array Konstruktor übergeben wird, eine ganze Zahl zwischen 0 und 232 - 1 (einschließlich) ist, wird ein neues JavaScript-Array zurückgegeben, bei dem die length Eigenschaft auf diese Zahl gesetzt ist.

Hinweis: Dies impliziert ein Array mit arrayLength leeren Plätzen, nicht Plätze mit tatsächlichen undefined Werten — siehe dünn besetzte Arrays.

Ausnahmen

RangeError

Wird geworfen, wenn es nur ein Argument (arrayLength) gibt, das eine Zahl ist, aber dessen Wert keine ganze Zahl ist oder nicht zwischen 0 und 232 - 1 (einschließlich) liegt.

Beispiele

Array-Literal-Notation

Arrays können mit der Literal-Notation erstellt werden:

js
const fruits = ["Apple", "Banana"];

console.log(fruits.length); // 2
console.log(fruits[0]); // "Apple"