Array() Konstruktor
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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)
Hinweis:Array()
kann mit oder ohnenew
aufgerufen werden. Beides erstellt eine neueArray
Instanz.
Parameter
element1
, …,elementN
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 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 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 dielength
Eigenschaft auf diese Zahl gesetzt ist.Hinweis:Dies impliziert ein Array mit
arrayLength
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 232 - 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
Specification |
---|
ECMAScript® 2026 Language Specification # sec-array-constructor |
Browser-Kompatibilität
Siehe auch
MDN-Feedback-Box
Diese Seite wurde automatisch aus dem Englischen übersetzt.