Array() constructor
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
El constructorArray()
se utiliza para crear objetosArray
.
Sintaxis
new Array(element0, element1, /* … ,*/ elementN)new Array(arrayLength)Array(element0, element1, /* … ,*/ elementN)Array(arrayLength)
Nota:Array()
puede ser llamado con o sinnew
. Ambos crean una nueva instancia deArray
.
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ámetroarrayLength
más abajo). Tenga en cuenta que este caso especial sólo se aplica a los arrays de JavaScript creadas con el constructorArray
, 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 delength
establecida a ese número (Nota: esto implica un array de ranuras vacías dearrayLength
, no ranuras con valores realesundefined
— versparse 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ónliteral:
const fruits = ["Apple", "Banana"];console.log(fruits.length); // 2console.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 propiedadlength
establecida a ese número y los elementos del array son ranuras vacías.
const fruits = new Array(2);console.log(fruits.length); // 2console.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 nuevoArray
con los elementos dados.
const fruits = new Array("Apple", "Banana");console.log(fruits.length); // 2console.log(fruits[0]); // "Apple"
Especificaciones
Specification |
---|
ECMAScript® 2026 Language Specification # sec-array-constructor |
Compatibilidad con navegadores
Véase también
- Clase
Array