Array() constructor

Sintaxis

new Array(element0, element1, /*  ,*/ elementN)
new Array(arrayLength)
Array(element0, element1, /*  ,*/ elementN)
Array(arrayLength)

Parmetros

elementN

Un array de JavaScript se inicializa con los elementos dados, excepto en el caso donde se pase un solo argumento al constructor de Array y ese argumento sea un nmero (vase el parmetro arrayLength ms abajo). Tenga en cuenta que este caso especial slo se aplica a los arrays de JavaScript creadas con el constructor Array, no a los arrays literales, creadas con la sintaxis de corchetes.

arrayLength

Si el nico argumento pasado al constructor de Array es un nmero entero entre 0 y 2^32 - 1 (incluido), ste devuelve un nuevo array de JavaScript con su propiedad de length establecida a ese nmero (Nota: esto implica un array de ranuras vacas de arrayLength, no ranuras con valores reales undefined ver sparse arrays).

Exceptions

RangeError

Se lanza si slo hay un argumento (arrayLength) y su valor no est entre 0 y 2^32 - 1 (incluido).

Ejemplos

Notacin literal de array

Los arrays pueden ser creados usando la notacin literal:

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

Constructor de array con un solo parmetro

Los arrays pueden ser creados usando un constructor con un solo parmetro numrico. Un array con su propiedad length establecida a ese nmero y los elementos del array son ranuras vacas.

const fruits = new Array(2);
console.log(fruits.length); // 2
console.log(fruits[0]); // undefined

Constructor de array con mltiples parmetros

Si se pasa ms de un argumento al constructor, se crea un nuevo Array con los elementos dados.

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

Especificaciones

Compatibilidad con navegadores

Vase tambin

• Clase Array