Array() Konstruktor

Syntax

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)

Parameter

element1, , elementN

Ein JavaScript-Array wird mit den angegebenen Elementen initialisiert, auer 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 (einschlielich) ist, wird ein neues JavaScript-Array zurckgegeben, bei dem die length Eigenschaft auf diese Zahl gesetzt ist.

Hinweis: Dies impliziert ein Array mit arrayLength leeren Pltzen, nicht Pltze mit tatschlichen undefined Werten siehe dnn 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 (einschlielich) liegt.

Beispiele

Array-Literal-Notation

Arrays knnen mit der Literal-Notation erstellt werden:

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

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

Array-Konstruktor mit einem einzelnen Parameter

Arrays knnen mit einem Konstruktor erstellt werden, der einen einzelnen numerischen Parameter hat. Ein Array wird erstellt, dessen length Eigenschaft auf diese Zahl gesetzt ist, und die Array-Elemente sind leere Pltze.

const arrayEmpty = new Array(2);

console.log(arrayEmpty.length); // 2
console.log(arrayEmpty[0]); // undefined; actually, it is an empty slot
console.log(0 in arrayEmpty); // false
console.log(1 in arrayEmpty); // false

const arrayOfOne = new Array("2"); // Not the number 2 but the string "2"

console.log(arrayOfOne.length); // 1
console.log(arrayOfOne[0]); // "2"

Array-Konstruktor mit mehreren Parametern

Wenn mehr als ein Argument an den Konstruktor bergeben wird, wird ein neuer Array mit den angegebenen Elementen erstellt.

const fruits = new Array("Apple", "Banana");

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Leitfaden fr indizierte Sammlungen
• Array