Array() constructor

Sintaxis

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

Parámetros

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 número (véase el parámetro arrayLength más abajo). Tenga en cuenta que este caso especial sólo 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 número entero entre 0 y 2^32 - 1 (incluido), éste devuelve un nuevo array de JavaScript con su propiedad de length establecida a ese número (Nota: esto implica un array de ranuras vacías de arrayLength, no ranuras con valores reales undefined — ver sparse arrays).

Exceptions

RangeError

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

Ejemplos

Notación literal de array

Los arrays pueden ser creados usando la notación literal:

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

Constructor de array con un solo parámetro

Los arrays pueden ser creados usando un constructor con un solo parámetro numérico. Un array con su propiedad length establecida a ese número y los elementos del array son ranuras vacías.

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

Constructor de array con múltiples parámetros

Si se pasa más 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

Véase también

• Clase Array