Referencia de ECMAScript 5.1 – Objeto Array

Índice

Array()

Función constructora de los objetos de tipo Array

Sintaxis

var matriz = new Array()
var matriz = new Array([NumElementos])
var matriz = new Array([elemento0[, elemento1[, ... elementoN]]])

NumElementos

Opcional. Número de elementos que debe contener la matriz.

elemento0...elementoN

Opcional. Elementos de la matriz.

Si se crea sin indicar ningún parámetro, se creará una matriz de 0 elementos.

var matriz = Array()
var matriz = Array([NumElementos])
var matriz = Array([elemento0[, elemento1[, ... elementoN]]])

La función constructora Array() puede ser invocada como una función devolviendo un objeto tipo Array de forma similar a los creados con new Array().

var matriz = [];
var matriz = [elemento1, elemento2, elementoN];

Los objetos de tipo Array también se pueden crear utilizando un literal formato por dos corchetes [], que pueden contener los elementos de la matriz separados por comas. Este tipo básico de Javascript se convertirá en un objeto Array siempre que sea necesario.

Ejemplo

// Matriz conteniendo tipos de frutas
var frutas = new Array('peras', 'manzanas', 'kiwi');
console.log(frutas[0]);

Los elementos de las matrices empiezan en 0 y pueden ser manejados de forma similar a las variables con el nombre de la matriz y el número del elemento entre corchetes [].

Los elmentos de las matrices pueden ser de cualquier tipo de datos, incluido otras matrices, pudiendo de esta forma simular matrices multidimensionales.

La función Array dispone de un método y varias propiedades que pueden ser utilizados sin necesidad de crear un objeto con new. Estas propiedades y métodos se utilizan de la siguiente forma:

Array.isArray(object)

Las instancias de los objetos del tipo Array disponen de las propiedades y métodos definidos en Array.prototype.

ECMA-262

Array.prototype

Prototipo de los objetos del tipo Array.

Sintaxis

Object.prototype

El prototipo incluye todas las propiedades y métodos que heredarán los objetos del tipo Array.

Si al objeto prototype se le añade o modifican propiedades o métodos, todos los objetos creados a partir del tipo Array tendrán estos nuevos miembros, incluso los creados con anterioridad a la modificación del prototipo.

ECMA-262

Array.isArray()

Devuelve un valor de tipo booleano que indica si un objeto es una matriz.

Sintaxis

Array.isArray(matriz)

matriz

Variable que se quiere comprobar si es una matriz.

Devuelve true si la variable contiene una matriz y false si contiene cualquier otro tipo de datos.

Ejemplo

var matriz = [];
console.log(Array.isArray(matriz));  // true

var objeto = {};
console.log(Array.isArray(objeto));  // false

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

arr.length

Contiene el tamaño de la matriz.

Sintaxis

arr.length

arr

matriz de la que se quiere obtener el tamaño.

Esta propiedad contiene el tamaño de la matriz, es decir, un valor que supera en 1 al indice del elemento mayor definido en la matriz.

Ejemplo

var frutas = new Array('manzanas', 'peras', 'kiwi');
for (var cont = 0; cont < frutas.length; cont++) {
    console.log(frutas[cont]);
}

Crea una matriz conteniendo el nombre de frutas y recorre esta matriz con un bucle for donde consulta el tamaño de la matriz en cada ciclo.

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"value": 0, "writable": true, "enumerable": false, "configurable": false}

ECMA-262

arr.concat()

Devuelve una matriz nueva que se compone de una combinación de varias matrices.

Sintaxis

arr.concat([valor1[, valor2[,... valorN]]])
arr.concat([elemento1[, elemento2[,... elementoN]]])

arr

Matriz base a la que se le añadirán otras matrices para crear una nueva. Esta matriz no es modificada.

valor1,... valorN

Nuevos elementos que se añadirán al final de la nueva matriz. Si estos elementos son matrices, se añadirán a la matriz base.

Se crea una nueva matriz con el contenido de la matriz base y de todos los elementos indicados, sin que ninguno de ellos sea modificado.

Ejemplo

var citricos = new Array('naranjas', 'limones', 'limas', 'pomelos');
var frutosdelbosque = new Array('moras', 'grosellas', 'arándanos');

var frutas = citricos.concat(frutosdelbosque);
console.dir(frutas);

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 3

arr.every()

Comprueba si una función callback devuelve true para todos los elementos de una matriz.

Sintaxis

arr.every(callback[, thisObj])

arr

Matriz que se va a revisar.

callback

Función que será llamada para cada uno de los miembros de la matriz mientras la función devuelva true. Si devuelve false se cancela la ejecución y every() devuelve directamente false.

thisObj

Opcional. Objeto que será referenciado como this dentro de la función callback. Si no se indica, this tendrá en valor undefined dentro de esa función.

La función llamada puede recibir hasta tres parámetros con estos valores:

function callback(valor, indice, matriz)

valor

Valor del elemento de la matriz.

indice

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

La función callback puede modificar la matriz, pero hay que tener en cuenta que si se agrega un nuevo elemento este no será pasado a la función callback, si se modifica sólo será pasado a la función callback si no se habia llamado ya. Si se elimina un elemento y este no ha sido ya procesado, no será pasado a la función callback.

Ejemplo

// Función que comprueba si el valor pasado el un número primo
function esPrimo(num) {
    for (var j = 2; j < num ; j++){
        if (num % j == 0){
            return false;
        }
    }
    return true;
}
// Comprobamos una matriz donde todos son numeros primos
var todosPrimos = new Array( 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47);
console.log(todosPrimos.every(esPrimo));   // true
// Comprobamos una matriz donde todos son numeros primos menos el último valor
var noTodosPrimos = new Array( 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 48);
console.log(noTodosPrimos.every(esPrimo)); // false

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

arr.filter()

Llama a una función callback para cada elemento de una matriz y devuelve una matriz de aquellos valores para los que esa función devuelve true.

Sintaxis

arr.filter(callback[, thisObj])

arr

Matriz que se va a revisar.

callback

Función que será llamada para cada uno de los miembros de la matriz.

thisObj

Opcional. Objeto que será referenciado como this dentro de la función callback. Si no se indica, this tendrá en valor undefined dentro de esa función.

La función llamada puede recibir hasta tres parámetros con estos valores:

function callback(valor, indice, matriz)

valor

Valor del elemento de la matriz.

indice

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

Ejemplo

// Función que comprueba si el valor pasado el un número primo
function esPrimo(num) {
    for (var j = 2; j < num ; j++){
        if (num % j == 0){
            return false;
        }
    }
    return true;
}
// Devuelve una matriz sólo con los números primos
var numeros = new Array( 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20);
var todosPrimos = numeros.filter(esPrimo);
console.dir(todosPrimos); // [1, 2, 3, 5, 7, 11, 13, 17, 19]

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

arr.forEach()

Llama a una función callback para cada elemento de una matriz.

Sintaxis

arr.forEach(callback[, thisObj])

arr

Matriz que se va a procesar.

callback

Función que será llamada para cada uno de los miembros de la matriz.

thisObj

Opcional. Objeto que será referenciado como this dentro de la función callback. Si no se indica, this tendrá en valor undefined dentro de esa función.

La función llamada puede recibir hasta tres parámetros con estos valores:

function callback(valor, indice, matriz)

valor

Valor del elemento de la matriz.

indice

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

Ejemplo

var frutas = new Array('manzanas', 'peras', 'kiwi');
frutas.forEach(function (valor, indice) {
    console.log( 'indice:' + indice + ' valor:' +  valor);
});

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

matriz.indexOf()

Devuelve el índice de la primera aparición de un valor de una matriz.

Sintaxis

arr.indexOf(buscado[, desdeIndice])

arr

Matriz que se va a procesar.

buscado

Valor buscado dentro de la matriz.

desdeIndice

Opcional. Índice desde el que se va a realizar la búsqueda.

Si no se encuentra el valor buscado, devuelve -1. Si se encuentra devuelve el indice del elemento. La búsqueda se realiza en orden ascendente de índice y se comparan sin realizar conversiones de tipo, es decir, se comparan por igualdad estricta de forma similar al operador ===.

Ejemplo

var frutas = new Array('manzanas', 'peras', 'kiwi');
console.log(frutas.indexOf('peras')); // 1
console.log(frutas.indexOf('leche')); // -1

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edición 5

arr.join()

Devuelve una cadena formada por todos los elementos de una matriz concatenados.

Sintaxis

arr.join([separador])

separador

Opcional. Cadena que será utilizada como separador de los elementos. Si se omite los elementos se separarán por medio de comas (,).

Si alguno de los elementos de la matriz es undefined o null se tratará como una cadena vacía.

Ejemplo

var matriz = new Array(0,1,2,3,4);
var cadena = matriz.join("-");
console.log(cadena);               // 0-1-2-3-4

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262

arr.lastIndexOf()

Devuelve el índice de la última aparición de un valor especificado de una matriz.

Sintaxis

arr.lastIndexOf(buscado[, desdeIndice])

arr

Matriz que se va a procesar.

buscado

Valor buscado dentro de la matriz.

desdeIndice

Opcional. Índice desde el que se va a realizar la búsqueda.

Si no se encuentra el valor buscado, devuelve -1. Si se encuentra devuelve el indice del elemento. La búsqueda se realiza en orden descendente de índice y se comparan sin realizar conversiones de tipo, es decir, se comparan por igualdad estricta de forma similar al operador ===.

Ejemplo

var frutas = new Array('peras', 'manzanas', 'peras', 'kiwi');  // se repite el valor 'peras'
console.log(frutas.lastIndexOf('peras'));                      // 2, obtiene el valor de la última aparición
console.log(frutas.lastIndexOf('leche'));                      // -1

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262

arr.map()

Llama a una función callback para cada elemento de una matriz y devuelve una matriz que contiene los resultados.

Sintaxis

arr.map(callback[, thisObj])

arr

Matriz que se va a procesar.

callback

Función que será llamada para cada uno de los miembros de la matriz.

thisObj

Opcional. Objeto que será referenciado como this dentro de la función callback. Si no se indica, this tendrá en valor undefined dentro de esa función.

La función llamada puede recibir hasta tres parámetros con estos valores:

function callback(valor, indice, matriz)

valor

Valor del elemento de la matriz.

indice

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

Cada uno de los valores retornados por esta función será almacenados en la matriz que devuelve el método map().

Ejemplo

// Función que comprueba si el valor pasado el un número primo
function cuadrado(num) {
    return num * num;
}
// Devuelve una matriz sólo con los números primos
var numeros = new Array( 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20);
var numerosalcuadrado = numeros.map(cuadrado);
console.dir(numerosalcuadrado); // [1,4,9,16,25,36,49,64,81,100,121,144,169,196,225,256,289,324,361,400]

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

arr.pop()

Quita el último elemento de una matriz y lo devuelve.

Sintaxis

arr.pop()

arr

Matriz que se va a borrar su último elemento.

Si la matriz no tiene ningún elemento el método pop() devuelve undefined.

Ejemplo

var matriz = new Array(5, 6, 7);
numero = matriz.pop();
do {
    console.log(numero);
    numero = matriz.pop();
} while (numero != undefined)

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 3

arr.push()

Añade nuevos elementos a una matriz y devuelve la nueva longitud de la matriz.

Sintaxis

arr.push([elemento1[, elemento2[,... elementoN]]])

arr

Matriz que se van a añadir elementos.

elemento1...elementoN

Elementos que se van a añadir a la matriz.

Si uno de los elementos a añadir es una matriz, se añadirá como un sólo elemento. Si se quieren añadir los elementos de la matriz deberá utilizarse concat().

Ejemplo

var matriz = [1, 5, 7];
matriz.push(11, 13, 17);
console.dir(matriz.toString());        // 1,5,7,11,13,17

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 3

arr.reduce()

Acumula un solo resultado llamando a una función callback para todos los elementos de una matriz.

Sintaxis

arr.reduce(callback[, valorinicial])

arr

Matriz que se va a procesar.

callback

Función que será llamada para cada uno de los miembros de la matriz.

valorinicial

Opcional. Valor inicial que se pasará a la función callback. Si no se indica, se pasará el primer elemento de la matriz y la función callback se llamará a partir del segundo elemento de la matriz.

La función llamada puede recibir hasta cuatro parámetros con estos valores:

function callback(valorprevio, valoractual, indiceactual, matriz)

valorprevio

Valor devuelto por la llamada anterior a la función callback. La primera vez que se llama, si se ha indicado un valorinicial se pasará en este parámetro, si no se indica, contendrá el primer valor de la matriz.

valoractual

Valor del elemento de la matriz que se está procesando.

indiceactual

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

El valor devuelto de la función callback es el resultado acumulado, y se proporciona como argumento en la siguiente llamada a dicha función.

Ejemplos

// Suma todos los valores de la matriz
var numeros = [1, 2, 3, 5, 7, 11, 13, 17, 19];
var sumatotal = numeros.reduce(function (valorprevio, valoractual) {
    return valorprevio + valoractual;
});
console.log(sumatotal);   // 78

// Suma los cuadrados de los valores de la matriz
function sumacuadrados(valorinicial, valoractual) {
    return valorinicial + (valoractual * valoractual);
}
var numeros = [1, 2, 3, 5, 7, 11, 13, 17, 19];
var sumatotal = numeros.reduce(sumacuadrados, 0);
console.log(sumatotal);   // 1028

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

arr.reduceRight()

Acumula un solo resultado llamando a una función callback para todos los elementos de una matriz, en orden descendente.

Sintaxis

arr.reduceRight(callback[, valorinicial])

arr

Matriz que se va a procesar.

callback

Función que será llamada para cada uno de los miembros de la matriz de forma descendente.

valorinicial

Opcional. Valor inicial que se pasará a la función callback. Si no se indica, se pasará el último elemento de la matriz y la función callback se llamará a partir del penúltimo elemento de la matriz.

La función llamada puede recibir hasta cuatro parámetros con estos valores:

function callback(valorprevio, valoractual, indiceactual, matriz)

valorprevio

Valor devuelto por la llamada anterior a la función callback. La primera vez que se llama, si se ha indicado un valorinicial se pasará en este parámetro, si no se indica, contendrá el primer valor de la matriz.

valoractual

Valor del elemento de la matriz que se está procesando.

indiceactual

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

El valor devuelto de la función callback es el resultado acumulado, y se proporciona como argumento en la siguiente llamada a dicha función.

Ejemplo

// Une todos los elementos de la matriz en una cadena en orden inverso
var numeros = [1, 2, 3, 5, 7, 11, 13, 17, 19];
var unidos = numeros.reduce(function (valorprevio, valoractual) {
    return valoractual + ',' + valorprevio;
});
console.log(unidos);   // 19,17,13,11,7,5,3,2,1

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edicion 5

arr.reverse()

Devuelve un objeto Array con los elementos invertidos.

Sintaxis

arr.reverse()

arr

Matriz que se quiere invertir.

No se crea una nueva matriz, se invierten los valores de la matriz.

Ejemplo

var matriz = new Array(5, 6, 7);
matriz.reverse();
console.dir(matriz.toString());  // 7,6,5

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262

arr.shift()

Quita el primer elemento de una matriz y lo devuelve.

Sintaxis

arr.shift()

arr

Matriz que se va a borrar su primer elemento.

Si la matriz no tiene ningún elemento el método shift() devuelve undefined.

Ejemplo

var matriz = new Array(5, 6, 7);
numero = matriz.shift();
do {
    console.log(numero);
    numero = matriz.pop();
} while (numero != undefined)

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edición 3

arr.slice()

Devuelve una sección de una matriz.

Sintaxis

arr.slice(inicio[, fin])

arr

Matriz que se va a borrar su primer elemento.

inicio

Índice del primer elemento que se quiere obtener. Si el valor es negativo se entendrá que empieza desde el final de la matriz hasta el inicio.

fin

Índice del último elemento que ya no se obtendrá, es decir, ese elemento no se incluye en el retorno. Si el valor es negativo se entendrá que empieza desde el final de la matriz hasta el inicio. Si no se incluye se obtiene los valores hasta el final de la matriz.

Retorna una nueva matriz con los elementos seleccionados.

Ejemplo

var numeros = [1, 2, 3, 5, 7, 11, 13, 17, 19];
// Se obtienen los tres primeros valores
console.dir(numeros.slice(0, 3));   // 1,2,3
// Se obtienen los valores entre las posiciones 2 y 5
console.dir(numeros.slice(2, 5));   // 3,5,7
// Se obtienen los valores entre la posición 6 hasta la última
console.dir(numeros.slice(6));      // 13,17,19
// Se obtienen los valores entre las posiciones 5 a 2 desde el final de la matriz
console.dir(numeros.slice(-5, -2)); // 7,11,13

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edición 3

arr.some()

Comprueba si una función callback devuelve true para al menos un elemento de una matriz.

Sintaxis

arr.some(callback[, thisObj])

arr

Matriz que se va a revisar.

callback

Función que será llamada para cada uno de los miembros de la matriz mientras la función devuelva false. Si devuelve true se cancela la ejecución y some() devuelve directamente true.

thisObj

Opcional. Objeto que será referenciado como this dentro de la función callback. Si no se indica, this tendrá en valor undefined dentro de esa función.

La función llamada puede recibir hasta tres parámetros con estos valores:

function callback(valor, indice, matriz)

valor

Valor del elemento de la matriz.

indice

Índice de elemento de la matriz que se está procesando.

matriz

Referencia de la matriz que contine todos los valores.

Ejemplo

// Función que comprueba si el valor es negativo
function esNegativo(num) {
    return num < 0;
}
// Comprobamos si hay algún valor negativo en la matriz
var todosPrimos = new Array( 2, 3, 5, 7, -11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47);
console.log(todosPrimos.some(esNegativo));   // true
// Comprobamos una matriz donde todos positivos
var noTodosPrimos = new Array( 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47);
console.log(noTodosPrimos.some(esNegativo)); // false

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edición 5

arr.sort()

Devuelve un objeto Array con los elementos ordenados.

Sintaxis

arr.sort([callback])

arr

Matriz que se quiere ordenar.

callback

Opcional. Función que se utilizará para ordenar la matriz. Si se omite se utilizará una ordenación de los caracteres ASCII.

La función callback recibe dos parámetros:

function callback(primervalor, segundovalor)

primervalor

Primer valor que se va a comparar dentro de la matriz.

segundovalor

Segundo valor que se va a comparar dentro de la matriz.

La función devolver uno de estos valores:

Un valor negativo si primervalor es menor que segundovalor.
0 si los dos argumentos son equivalentes.
Un valor positivo si primervalor es mayor que segundovalor.

No se crea una nueva matriz, se ordenan los valores de la matriz existente.

Ejemplo

var matriz = new Array(5, 6, 7);
matriz.reverse();
console.dir(matriz.toString());  // 7,6,5

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262

arr.splice()

Quita elementos de una matriz, inserta nuevos elementos en su lugar si procede y devuelve los elementos eliminados.

Sintaxis

arr.splice(inicio, numero, [elemento1[, elemento2[,...[,elementoN]]]])

inicio

Índice desde el que se borran elementos

numero

Número de elementos a borrar

elemento1...elementoN

Opcional. Elementos que se insertarán en el lugar de los elementos borrados.

Los elementos eliminados se devuelven como un nuevo objeto Array.

Ejemplo

var frutas = ['naranjas', 'manzanas', 'leche', 'arroz', 'kiwi'];
frutas.splice(2, 2, 'uvas', 'limones');
console.log(frutas.toString()); // naranjas,manzanas,uvas,limones,kiwi

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edición 3

arr.unshift()

Inserta nuevos elementos al principio de una matriz.

Sintaxis

arr.unshift(elemento1[, elemento2[,... elementoN]])

arr

Matriz que se va a insertar elementos al principio de la misma.

elemento1...elementoN

Opcional. Elementos que se insertarán al inicio de la matriz.

Devuelve el número de elementos que tiene la matriz tras la inserción.

Ejemplo

var matriz = new Array();
matriz.unshift(10, 11);
matriz.unshift(12, 13, 14);
console.log(matriz.toString());  // 12,13,14,10,11

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}

ECMA-262 Edición 3