TheArray() constructor createsArray objects.

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)

Parameters

element1, …,elementN

A JavaScript array is initialized with the given elements, except in the case wherea single argument is passed to theArray constructor and that argument isa number (see thearrayLength parameter below). Note that this special case onlyapplies to JavaScript arrays created with theArray constructor, notarray literals created with the square bracket syntax.

arrayLength

If the only argument passed to theArray constructor is an integerbetween 0 and 2³² - 1 (inclusive), this returns a new JavaScript array withitslength property set to that number.

Note:This implies an array ofarrayLength empty slots, not slots with actualundefined values — seesparse arrays).

Exceptions

RangeError

Thrown if there's only one argument (arrayLength) that is a number, but its value is not an integer or not between 0 and 2³² - 1 (inclusive).

Examples

Array literal notation

Arrays can be created using theliteralnotation:

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

Array constructor with a single parameter

Arrays can be created using a constructor with a single number parameter. An array is created withitslength property set to that number, and the array elements are emptyslots.

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 constructor with multiple parameters

If more than one argument is passed to the constructor, a newArray withthe given elements is created.

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

Specifications

Browser compatibility

See also

• Indexed collections guide
• Array