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. Eine Ausnahme gilt, wenn dem Array-Konstruktor nur ein Argument bergeben wird und dieses eine Zahl ist (siehe den Parameter arrayLength weiter unten). Dieser Sonderfall gilt nur fr JavaScript-Arrays, die mit dem Array-Konstruktor erstellt werden, nicht fr Array-Literale mit eckigen Klammern.

arrayLength

Wenn das einzige an den Array-Konstruktor bergebene Argument eine Ganzzahl zwischen 0 und 232 - 1 (einschlielich) ist, wird ein neues JavaScript-Array zurckgegeben, dessen length-Eigenschaft auf diese Zahl gesetzt ist.

Hinweis: Das bedeutet, dass das Array arrayLength leere Pltze enthlt, nicht Pltze mit tatschlichen undefined-Werten siehe Arrays mit leeren Pltzen.

Ausnahmen

RangeError

Wird ausgelst, wenn nur ein Argument (arrayLength) bergeben wird, das eine Zahl ist, deren Wert aber keine Ganzzahl ist oder nicht zwischen 0 und 232 - 1 (einschlielich) liegt.

Beispiele

Array-Literalnotation

Arrays knnen mit der Literalnotation 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, dem eine einzelne Zahl als Parameter bergeben wird. Dabei entsteht ein Array, dessen length-Eigenschaft auf diese Zahl gesetzt ist und dessen Elemente leere Pltze sind.

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 dem Konstruktor mehr als ein Argument bergeben wird, wird ein neues 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

• Indizierte Sammlungen Leitfaden
• Array