Array() Konstruktor

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)

Note: Array() kann mit oder ohne new aufgerufen werden. Beide erstellen eine neue Array-Instanz.

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 den arrayLength-Parameter unten). Beachten Sie, dass dieser Spezialfall nur für JavaScript-Arrays gilt, die mit dem Array-Konstruktor erstellt wurden, nicht für Array-Literale, die mit der eckigen Klammer-Syntax erstellt wurden.

arrayLength

Wenn das einzige Argument, das an den Array-Konstruktor übergeben wird, eine ganze Zahl zwischen 0 und 2³² - 1 (einschließlich) ist, wird ein neues JavaScript-Array mit seiner length-Eigenschaft auf diese Zahl gesetzt zurückgegeben (Hinweis: Das impliziert ein Array von arrayLength leeren Slots, nicht Slots mit tatsächlichen undefined Werten — siehe sparse arrays).

RangeError

Wird ausgelöst, wenn nur ein Argument (arrayLength) übergeben wird, das eine Zahl ist, dessen Wert jedoch keine ganze Zahl ist oder nicht zwischen 0 und 2³² - 1 (einschließlich) liegt.

Arrays können mit der Literal-Notation erstellt werden:

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

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

Arrays können mit einem Konstruktor erstellt werden, der einen einzigen Zahlenparameter hat. Ein Array wird erstellt, dessen length-Eigenschaft 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"

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"

• Indizierte Sammlungen Leitfaden
• Array