Array() Konstruktor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Der Array()
Konstruktor erstellt Array
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 ohne new
aufgerufen werden. Beide erzeugen eine neue Array
Instanz.
Parameter
element1
, …,elementN
-
Ein JavaScript-Array wird mit den angegebenen Elementen initialisiert, außer in dem Fall, dass ein einzelnes Argument an den
Array
Konstruktor übergeben wird und dieses Argument eine Zahl ist (siehe denarrayLength
Parameter unten). Beachten Sie, dass dieser Sonderfall nur für JavaScript-Arrays gilt, die mit demArray
Konstruktor erstellt wurden, nicht für Array-Literale, die mit der eckigen Klammer-Syntax erstellt werden. arrayLength
-
Wenn das einzige an den
Array
Konstruktor übergebene Argument eine Ganzzahl zwischen 0 und 232 - 1 (einschließlich) ist, wird ein neues JavaScript-Array mit seinerlength
Eigenschaft erstellt, die auf diese Zahl gesetzt ist (Hinweis: dies impliziert ein Array vonarrayLength
leeren Slots, nicht Slots mit tatsächlichenundefined
Werten — siehe dünnbesetzte Arrays).
Ausnahmen
RangeError
-
Ausgelöst, wenn es nur ein Argument (
arrayLength
) gibt, das eine Zahl ist, ihr Wert jedoch keine Ganzzahl ist oder nicht zwischen 0 und 232 - 1 (einschließlich) liegt.
Beispiele
Array-Literalnotation
Arrays können 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 können mit einem Konstruktor erstellt werden, der einen einzigen Zahlenparameter hat. Ein Array wird erstellt mit
seiner length
Eigenschaft, die auf diese Zahl gesetzt ist, und die Array-Elemente sind leere
Slots.
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 neues Array
mit
den angegebenen Elementen erstellt.
const fruits = new Array("Apple", "Banana");
console.log(fruits.length); // 2
console.log(fruits[0]); // "Apple"
Spezifikationen
Specification |
---|
ECMAScript® 2026 Language Specification # sec-array-constructor |
Browser-Kompatibilität
Siehe auch
- Indizierte Sammlungen Leitfaden
Array