Array() | Array.prototype | Array.isArray() | arr.length | arr.concat() | arr.every() | arr.filter() | arr.forEach() | matriz.indexOf() | arr.join() | arr.lastIndexOf() | arr.map() | arr.pop() | arr.push() | arr.reduce() | arr.reduceRight() | arr.reverse() | arr.shift() | arr.slice() | arr.some() | arr.sort() | arr.splice() | arr.unshift()
Array()
Función constructora de los objetos de tipo Array
Sintaxisvar matriz = new Array()
var matriz = new Array([NumElementos])
var matriz = new Array([elemento0[, elemento1[, ... elementoN]]])
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]);
// 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
.
Array.prototype
Prototipo de los objetos del tipo Array
.
SintaxisObject.prototype
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.
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.
Ejemplovar matriz = [];
console.log(Array.isArray(matriz)); // true
var objeto = {};
console.log(Array.isArray(objeto)); // false
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}
arr.length
Contiene el tamaño de la matriz.
Sintaxisarr.length
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.
Ejemplovar frutas = new Array('manzanas', 'peras', 'kiwi');
for (var cont = 0; cont < frutas.length; cont++) {
console.log(frutas[cont]);
}
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}
arr.concat()
Devuelve una matriz nueva que se compone de una combinación de varias matrices.
Sintaxisarr.concat([valor1[, valor2[,... valorN]]])
arr.concat([elemento1[, elemento2[,... elementoN]]])
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.
Ejemplovar citricos = new Array('naranjas', 'limones', 'limas', 'pomelos');
var frutosdelbosque = new Array('moras', 'grosellas', 'arándanos');
var frutas = citricos.concat(frutosdelbosque);
console.dir(frutas);
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}
arr.every()
Comprueba si una función callback devuelve true
para todos los elementos de una matriz.
Sintaxisarr.every(callback[, thisObj])
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 devuelvefalse
se cancela la ejecución yevery()
devuelve directamentefalse
.
thisObj
Opcional. Objeto que será referenciado como
this
dentro de la funcióncallback
. Si no se indica,this
tendrá en valorundefined
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
// 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}
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
.
Sintaxisarr.filter(callback[, thisObj])
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óncallback
. Si no se indica,this
tendrá en valorundefined
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;
}
// 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]
// 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}
arr.forEach()
Llama a una función callback para cada elemento de una matriz.
Sintaxisarr.forEach(callback[, thisObj])
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óncallback
. Si no se indica,this
tendrá en valorundefined
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
.
Ejemplovar frutas = new Array('manzanas', 'peras', 'kiwi');
frutas.forEach(function (valor, indice) {
console.log( 'indice:' + indice + ' valor:' + valor);
});
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}
matriz.indexOf()
Devuelve el índice de la primera aparición de un valor de una matriz.
Sintaxisarr.indexOf(buscado[, desdeIndice])
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 ===
.
Ejemplovar frutas = new Array('manzanas', 'peras', 'kiwi');
console.log(frutas.indexOf('peras')); // 1
console.log(frutas.indexOf('leche')); // -1
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}
arr.join()
Devuelve una cadena formada por todos los elementos de una matriz concatenados.
Sintaxisarr.join([separador])
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.
Ejemplovar matriz = new Array(0,1,2,3,4);
var cadena = matriz.join("-");
console.log(cadena); // 0-1-2-3-4
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}
arr.lastIndexOf()
Devuelve el índice de la última aparición de un valor especificado de una matriz.
Sintaxisarr.lastIndexOf(buscado[, desdeIndice])
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 ===
.
Ejemplovar 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
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}
arr.map()
Llama a una función callback para cada elemento de una matriz y devuelve una matriz que contiene los resultados.
Sintaxisarr.map(callback[, thisObj])
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óncallback
. Si no se indica,this
tendrá en valorundefined
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
.
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]
// 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}
arr.pop()
Quita el último elemento de una matriz y lo devuelve.
Sintaxisarr.pop()
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
.
Ejemplovar matriz = new Array(5, 6, 7);
numero = matriz.pop();
do {
console.log(numero);
numero = matriz.pop();
} while (numero != undefined)
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}
arr.push()
Añade nuevos elementos a una matriz y devuelve la nueva longitud de la matriz.
Sintaxisarr.push([elemento1[, elemento2[,... elementoN]]])
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()
.
Ejemplovar matriz = [1, 5, 7];
matriz.push(11, 13, 17);
console.dir(matriz.toString()); // 1,5,7,11,13,17
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}
arr.reduce()
Acumula un solo resultado llamando a una función callback para todos los elementos de una matriz.
Sintaxisarr.reduce(callback[, valorinicial])
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óncallback
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 unvalorinicial
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.
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
.
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
// 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}
arr.reduceRight()
Acumula un solo resultado llamando a una función callback para todos los elementos de una matriz, en orden descendente.
Sintaxisarr.reduceRight(callback[, valorinicial])
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óncallback
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 unvalorinicial
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.
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
.
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
// 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}
arr.reverse()
Devuelve un objeto Array
con los elementos invertidos.
Sintaxisarr.reverse()
arr.reverse()
arr
Matriz que se quiere invertir.
No se crea una nueva matriz, se invierten los valores de la matriz.
Ejemplovar matriz = new Array(5, 6, 7);
matriz.reverse();
console.dir(matriz.toString()); // 7,6,5
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}
arr.shift()
Quita el primer elemento de una matriz y lo devuelve.
Sintaxisarr.shift()
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
.
Ejemplovar matriz = new Array(5, 6, 7);
numero = matriz.shift();
do {
console.log(numero);
numero = matriz.pop();
} while (numero != undefined)
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}
arr.slice()
Devuelve una sección de una matriz.
Sintaxisarr.slice(inicio[, fin])
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.
Ejemplovar 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
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}
arr.some()
Comprueba si una función callback devuelve true
para al menos un elemento de una matriz.
Sintaxisarr.some(callback[, thisObj])
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 devuelvetrue
se cancela la ejecución ysome()
devuelve directamentetrue
.
thisObj
Opcional. Objeto que será referenciado como
this
dentro de la funcióncallback
. Si no se indica,this
tendrá en valorundefined
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 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
// 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}
arr.sort()
Devuelve un objeto Array
con los elementos ordenados.
Sintaxisarr.sort([callback])
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 quesegundovalor
. - 0 si los dos argumentos son equivalentes.
- Un valor positivo si
primervalor
es mayor quesegundovalor
.
No se crea una nueva matriz, se ordenan los valores de la matriz existente.
Ejemplovar matriz = new Array(5, 6, 7);
matriz.reverse();
console.dir(matriz.toString()); // 7,6,5
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}
arr.splice()
Quita elementos de una matriz, inserta nuevos elementos en su lugar si procede y devuelve los elementos eliminados.
Sintaxisarr.splice(inicio, numero, [elemento1[, elemento2[,...[,elementoN]]]])
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
.
Ejemplovar frutas = ['naranjas', 'manzanas', 'leche', 'arroz', 'kiwi'];
frutas.splice(2, 2, 'uvas', 'limones');
console.log(frutas.toString()); // naranjas,manzanas,uvas,limones,kiwi
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}
arr.unshift()
Inserta nuevos elementos al principio de una matriz.
Sintaxisarr.unshift(elemento1[, elemento2[,... elementoN]])
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.
Ejemplovar matriz = new Array();
matriz.unshift(10, 11);
matriz.unshift(12, 13, 14);
console.log(matriz.toString()); // 12,13,14,10,11
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}