DerArray() Konstruktor erstelltArray Objekte.

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, außer im Fall, dass ein einzelnes Argument an denArray Konstruktor übergeben wird und dieses Argument eine Zahl ist (siehe denarrayLength Parameter unten). Beachten Sie, dass sich dieser Sonderfall nur auf mit demArray Konstruktor erstellte JavaScript-Arrays bezieht, nicht auf mit der eckigen Klammer-Syntax erstellte Array-Literale.

arrayLength

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

Hinweis:Dies impliziert ein Array mitarrayLength leeren Plätzen, nicht Plätze mit tatsächlichenundefined Werten — siehedü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 2³² - 1 (einschließlich) liegt.

Beispiele

Array-Literal-Notation

Arrays können mit derLiteral-Notation erstellt werden:

const fruits = ["Apple", "Banana"];console.log(fruits.length); // 2console.log(fruits[0]); // "Apple"

Array-Konstruktor mit einem einzelnen Parameter

Arrays können mit einem Konstruktor erstellt werden, der einen einzelnen numerischen Parameter hat. Ein Array wird erstellt, dessenlength Eigenschaft auf diese Zahl gesetzt ist, und die Array-Elemente sind leere Plätze.

const arrayEmpty = new Array(2);console.log(arrayEmpty.length); // 2console.log(arrayEmpty[0]); // undefined; actually, it is an empty slotconsole.log(0 in arrayEmpty); // falseconsole.log(1 in arrayEmpty); // false

const arrayOfOne = new Array("2"); // Not the number 2 but the string "2"console.log(arrayOfOne.length); // 1console.log(arrayOfOne[0]); // "2"

Array-Konstruktor mit mehreren Parametern

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

const fruits = new Array("Apple", "Banana");console.log(fruits.length); // 2console.log(fruits[0]); // "Apple"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Leitfaden für indizierte Sammlungen
• Array