El objetoArray de JavaScript es un objeto global que es usado en la construcción dearrays, que son objetos tipo lista de alto nivel.

Descripción

Losarrays son objetos similares a una lista cuyo prototipo proporciona métodos para efectuar operaciones de recorrido y de mutación. Tanto la longitud como el tipo de los elementos de unarray son variables. Dado que la longitud de unarray puede cambiar en cualquier momento, y los datos se pueden almacenar en ubicaciones no contiguas, no hay garantía de que losarrays de JavaScript sean densos; esto depende de cómo el programador elija usarlos. En general estas características son cómodas, pero si, en su caso particular, no resultan deseables, puede considerar el uso dearrays con tipo.

Operaciones habituales

Crear un Array

let frutas = ["Manzana", "Banana"];console.log(frutas.length);// 2

Acceder a un elemento de Array mediante su índice

let primero = frutas[0];// Manzanalet ultimo = frutas[frutas.length - 1];// Banana

Recorrer un Array

frutas.forEach(function (elemento, indice, array) {  console.log(elemento, indice);});// Manzana 0// Banana 1

Añadir un elemento al final de un Array

let nuevaLongitud = frutas.push("Naranja"); // Añade "Naranja" al final// ["Manzana", "Banana", "Naranja"]

Eliminar el último elemento de un Array

let ultimo = frutas.pop(); // Elimina "Naranja" del final// ["Manzana", "Banana"]

Añadir un elemento al principio de un Array

let nuevaLongitud = frutas.unshift("Fresa"); // Añade "Fresa" al inicio// ["Fresa" ,"Manzana", "Banana"]

Eliminar el primer elemento de un Array

let primero = frutas.shift(); // Elimina "Fresa" del inicio// ["Manzana", "Banana"]

Encontrar el índice de un elemento del Array

frutas.push("Fresa");// ["Manzana", "Banana", "Fresa"]let pos = frutas.indexOf("Banana"); // (pos) es la posición para abreviar// 1

Eliminar un único elemento mediante su posición

Ejemplo:

Eliminamos "Banana" delarray pasándole dos parámetros: la posición del primer elemento que se elimina y el número de elementos que queremos eliminar. De esta forma,.splice(pos, 1) empieza en la posición que nos indica el valor de la variablepos y elimina 1 elemento. En este caso, comopos vale 1, elimina un elemento comenzando en la posición 1 delarray, es decir "Banana".

let elementoEliminado = frutas.splice(pos, 1);// ["Manzana", "Fresa"]

Eliminar varios elementos a partir de una posición

Nota:

Con.splice() no solo se puede eliminar elementos del array, si no que también podemos extraerlos guardándolo en un nuevo array. ¡Ojo! que al hacer esto estaríamos modificando el array de origen.

let vegetales = ["Repollo", "Nabo", "Rábano", "Zanahoria"];console.log(vegetales);// ["Repollo", "Nabo", "Rábano", "Zanahoria"]let pos = 1,  numElementos = 2;let elementosEliminados = vegetales.splice(pos, numElementos);// ["Nabo", "Rábano"] ==> Lo que se ha guardado en "elementosEliminados"console.log(vegetales);// ["Repollo", "Zanahoria"] ==> Lo que actualmente tiene "vegetales"

Copiar un Array

let copiaArray = vegetales.slice();// ["Repollo", "Zanahoria"]; ==> Copiado en "copiaArray"

Acceso a elementos de un array

Los índices de losarrays de JavaScript comienzan en cero, es decir, el índice del primer elemento de unarray es0, y el del último elemento es igual al valor de la propiedadlength delarray restándole 1.

Si se utiliza un número de índice no válido, se obtendráundefined.

let arr = [  "este es el primer elemento",  "este es el segundo elemento",  "este es el último elemento",];console.log(arr[0]); // escribe en consola 'este es el primer elemento'console.log(arr[1]); // escribe en consola 'este es el segundo elemento'console.log(arr[arr.length - 1]); // escribe en consola 'este es el último elemento'

Los elementos de unarray pueden considerarse propiedades del objeto tanto comotoString (sin embargo, para ser precisos,toString() es un método). Sin embargo, se obtendrá un error de sintaxis si se intenta acceder a un elemento de unarray de la forma siguiente, ya que el nombre de la propiedad no sería válido:

console.log(arr.0) // error de sintaxis

No hay nada especial ni en losarrays de JavaScript ni en sus propiedades que ocasione esto. En JavaScript, las propiedades cuyo nombre comienza con un dígito no pueden referenciarse con la notación punto y debe accederse a ellas mediante la notación corchete.

Por ejemplo, dado un objeto con una propiedad de nombre'3d', sólo podría accederse a dicha propiedad con la notación corchete.

let decadas = [1950, 1960, 1970, 1980, 1990, 2000, 2010]console.log(decadas.0)  // error de sintaxisconsole.log(decadas[0]) // funciona correctamente

renderizador.3d.usarTextura(modelo, 'personaje.png')renderizador['3d'].usarTextura(modelo, 'personaje.png')

Obsérvese que, en el último ejemplo, ha sido necesario poner'3d' entre comillas. Es posible usar también comillas con los índices del losarrays de JavaScript (p. ej.,decadas['2'] en vez dedecadas[2]), aunque no es necesario.

El motor de JavaScript transforma en un string el 2 dedecadas[2] a través de una conversión implícita mediantetoString. Por tanto,'2' y'02' harían referencia a dos posiciones diferentes en el objetodecadas, y el siguiente ejemplo podría dartrue como resultado:

console.log(decadas["2"] != decadas["02"]);

Relación entrelength y las propiedades numéricas

La propiedadlength de unarray de JavaScript está conectada con algunas otras de sus propiedades numéricas.

Varios de los métodos propios de unarray (p. ej.,join(),slice(),indexOf(), etc.) tienen en cuenta el valor de la propiedadlength de un array cuando se les llama.

Otros métodos (p. ej.,push(),splice(), etc.) modifican la propiedadlength de un array.

const frutas = [];frutas.push("banana", "manzana", "pera");console.log(frutas.length); // 3

Cuando se le da a una propiedad de unarray JavaScript un valor que corresponda a un índice válido para elarray pero que se encuentre fuera de sus límites, el motor actualizará el valor de la propiedadlength como corresponda:

frutas[5] = "fresa";console.log(frutas[5]); // 'fresa'console.log(Object.keys(frutas)); // ['0', '1', '2', '5']console.log(frutas.length); // 6

Si se aumenta el valor delength:

frutas.length = 10;console.log(frutas); // ['banana', 'manzana', 'pera', <2 empty items>, 'fresa', <4 empty items>]console.log(Object.keys(frutas)); // ['0', '1', '2', '5']console.log(frutas.length); // 10console.log(frutas[8]); // undefined

Si se disminuye el valor de la propiedadlength pueden eliminarse elementos:

frutas.length = 2;console.log(Object.keys(frutas)); // ['0', '1']console.log(frutas.length); // 2

Hay más información sobre este tema en la página sobreArray.length.

Creación de un array a partir de una expresión regular

El resultado de una búsqueda con unaRegExp en un string puede crear unarray de JavaScript. Este array tendrá propiedades y elementos que proporcionan información sobre la correspondencia encontrada. Para obtener unarray de esta forma puede utilizarseRegExp.exec(),String.match() oString.replace().

El siguiente ejemplo, y la tabla que le sigue, pueden ayudar a comprender mejor las propiedades y elementos a los que nos referimos:

// Buscar una d seguida de una o más b y, al final, de otra d// Recordar las b y la d final// No distinguir mayúsculas y minúsculasconst miRe = /d(b+)(d)/i;const miArray = miRe.exec("cdbBdbsbz");

Las propiedades y elementos que se obtienen de esta búsqueda son los siguientes:

Constructor

Array()

Crea un nuevo objetoArray.

Propiedades estáticas

get Array[@@species]

La función del constructor se utiliza para crear objetos derivados.

Métodos estáticos

Array.from()

Crea una nueva instancia deArray a partir desimilarAUnArray, un objeto iterable o parecido a unarray.

Array.isArray()

Devuelvetrue sivalor es unarray, yfalse en caso contrario.

Array.of()

Crea una nueva instancia deArray con un número variable de parámetros, independientemente del número y del tipo de dichos parámetros.

Propiedades de instancia

Array.prototype.length

Indica el número de elementos de unarray.

Array.prototype[@@unscopables]

Símbolo que contiene todos los nombres de las propiedades que se excluyen de un ámbito de enlacewith.

Métodos de instancia

Array.prototype.concat()

Devuelve un nuevoarray que es la concatenación de aquél sobre el que se invoca, seguido de otrosarray(s) o valor(es).

Array.prototype.copyWithin()

Copia una secuencia de elementos de unarray dentro del propioarray.

Array.prototype.entries()

Devuelve un nuevo objetoArray Iterator que contiene los pares clave/valor para cada índice delarray.

Array.prototype.every()

Devuelvetrue si todos los elementos delarray cumplen el predicado que recibe como parámetro.

Array.prototype.fill()

Asigna unvalor estático a todos los elementos delarray entre las posicionesinicio yfin.

Array.prototype.filter()

Devuelve un nuevoarray que contiene todos los elementos de aquél para el cual se llama que cumplan el predicado que se le pasa como parámetro.

Array.prototype.find()

Devuelve el primerelemento delarray que cumpla el predicado que se pasa como parámetro, oundefined si ninguno lo cumple.

Array.prototype.findIndex()

Devuelve el índice del primer elemento delarray que cumpla el predicado que se pasa como parámetro, o-1 si nunguno lo cumple.

Array.prototype.forEach()

Llama a la función pasada como parámetro para todos los elementos delarray.

Array.prototype.includes()

Determina si elarray contiene elvalorBuscado y devuelvetrue ofalse según sea el caso.

Array.prototype.indexOf()

Devuelve el índice del primer elemento delarray que sea igual aelementoBuscado, o-1 si no existe.

Array.prototype.join()

Concatena en un string todos los elementos de unarray.

Array.prototype.keys()

Devuelve un nuevoArray Iterator que contiene las claves de cada índice delarray.

Array.prototype.lastIndexOf()

Devuelve el índice del último elemento delarray que sea igual aelementoBuscado, o-1 si no existe.

Array.prototype.map()

Devuelve un nuevoarray que contiene el resultado de llamar a la función pasada como parámetro a todos los elementos delarray sobre el que se invoca.

Array.prototype.pop()

Elimina el último elemento de unarray, y devuelve dicho elemento.

Array.prototype.push()

Añade uno o más elementos al final de unarray y devuelve el nuevo valor de su propiedadlength.

Array.prototype.reduce()

Aplica la función pasada como parámetro a unacumulador y a cada valor delarray, que se recorre de izquierda a derecha, para reducirlo a un único valor.

Array.prototype.reduceRight()

Aplica la función pasada como parámetro a unacumulador y a cada valor delarray, que se recorre de derecha a izquierda, para reducirlo a un único valor.

Array.prototype.reverse()

Invierte el orden de los elementos de unarray (el primero pasa a ser el último y el último a ser el primero) en el propioarray. Este método modifica el array.

Array.prototype.shift()

Elimina el primer elemento de unarray, y devuelve dicho elemento.

Array.prototype.slice()

Extrae una porción delarray sobre el que se llama y devuelve un nuevoarray.

Array.prototype.some()

Devuelvetrue si al menos un elemento delarray cumple con el predicado que se pasa como parámetro.

Array.prototype.sort()

Ordena los elementos de unarray, modificando éste, y devuelve el array ordenado.

Array.prototype.splice()

Añade, borra o modifica elementos de unarray.

Array.prototype.toLocaleString()

Devuelve un string adaptado a la configuración regional que representa elarray y sus elementos. Redefine el métodoObject.prototype.toLocaleString().

Array.prototype.toString()

Devuelve un string que representa elarray y sus elementos. Redefine el métodoObject.prototype.toString().

Array.prototype.unshift()

Añada uno o más elementos al inicio de unarray y devuelve el nuevo valor delength para elarray resultante.

Array.prototype.values()

Devuelve un nuevo objetoArray Iterator que contiene los valores para cada índice delarray.

Array.prototype[@@iterator]()

Devuelve un nuevo objetoArray Iterator que contiene los valores para cada índice delarray.

Ejemplos

Creación de una matriz unidimensional

El siguiente ejemplo crea unarraymensajes con una longitud de 0, y luego asigna valores amensajes[0] y amensajes[99], con lo que la longitud delarray pasa a ser 100.

let mensajes = [];mensajes[0] = "Hola";mensajes[99] = "mundo";if (mensajes.length === 100) {  console.log("La longitud es de 100.");}

Creación de una matriz de dos dimensiones

El siguiente ejemplo crea una matriz bidimensional que representa un tablero de ajedrez. El primer movimiento se realiza copiando la'p' detablero[6][4] entablero[4][4]. La posición[6][4] se limpia.

let tablero = [  ["T", "C", "A", "D", "R", "A", "C", "T"],  ["P", "P", "P", "P", "P", "P", "P", "P"],  [" ", " ", " ", " ", " ", " ", " ", " "],  [" ", " ", " ", " ", " ", " ", " ", " "],  [" ", " ", " ", " ", " ", " ", " ", " "],  [" ", " ", " ", " ", " ", " ", " ", " "],  ["p", "p", "p", "p", "p", "p", "p", "p"],  ["t", "c", "a", "d", "r", "a", "c", "t"],];console.log(tablero.join("\n") + "\n\n");// Adelantar dos posiciones el peón de reytablero[4][4] = tablero[6][4];tablero[6][4] = " ";console.log(tablero.join("\n"));

Este es el resultado:

T,C,A,D,R,A,C,TP,P,P,P,P,P,P,P  , , , , , , ,  , , , , , , ,  , , , , , , ,  , , , , , , ,p,p,p,p,p,p,p,pt,c,a,d,r,a,c,tP,P,P,P,P,P,P,P  , , , , , , ,  , , , , , , ,  , , , ,p, , ,  , , , , , , ,p,p,p,p, ,p,p,pt,c,a,d,r,a,c,t

Uso de un array para tabular un conjunto de valores

valores = [];for (let x = 0; x < 10; x++) {  valores.push([2 ** x, 2 * x ** 2]);}console.table(valores);

da como resultado:

0  1  01  2  22  4  83  8  184  16  325  32  506  64  727  128  988  256  1289  512  162

(La primera columna es el índice).

Especificaciones

Compatibilidad con navegadores

Ver también

• En la Guía de #"/es/docs/Web/JavaScript/Guide/Working_with_objects#indexing_object_properties">"Propiedades indexadas de un objeto"

• "Colecciones con índice: objeto Array"