Array() constructor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
El constructor Array()
se utiliza para crear objetos Array
.
Sintaxis
new Array(element0, element1, /* … ,*/ elementN)
new Array(arrayLength)
Array(element0, element1, /* … ,*/ elementN)
Array(arrayLength)
Nota: Array()
puede ser llamado con o sin new
. Ambos crean una nueva instancia de Array
.
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
— 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
Specification |
---|
ECMAScript® 2025 Language Specification # sec-array-constructor |
Compatibilidad con navegadores
BCD tables only load in the browser
Véase también
- Clase
Array