Array() constructor
El constructor Array()
se utiliza para crear objetos Array
.
Sintaxis
js
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:
js
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.
js
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.
js
const fruits = new Array("Apple", "Banana");
console.log(fruits.length); // 2
console.log(fruits[0]); // "Apple"
Especificaciones
Specification |
---|
ECMAScript Language Specification # sec-array-constructor |
Compatibilidad con navegadores
BCD tables only load in the browser
Véase también
- Clase
Array