Método map() de Array en JavaScript

Array 对象参考手册Objeto Array de JavaScript

Ejemplo

Devuelve un array cuyos elementos son la raíz cuadrada de los elementos del array original:

var numbers = [4, 9, 16, 25];

function myFunction() {
    x = document.getElementById("demo")
    x.innerHTML = numbers.map(Math.sqrt);
}

El resultado es:

2,3,4,5

Pruébalo »

Definición y uso

El método map() devuelve un nuevo array cuyos elementos son los valores obtenidos al llamar a la función sobre los elementos del array original.

El método map() procesa los elementos en orden, siguiendo el orden del array original.

Nota:map() no comprueba arrays vacíos.

Nota:map() no modifica el array original.

Compatibilidad del navegador

Los números en la tabla indican la versión del navegador que soporta por primera vez este método.

Método
map() Yes 9 1.5 Yes Yes

Sintaxis

array.map(function(currentValue,index,arr), thisValue)

Descripción de parámetros

Parámetro Descripción
function(currentValue, index,arr) Obligatorio. Función que se ejecuta para cada elemento del array.
Parámetros de la función:
Parámetro Descripción
currentValue Obligatorio. El valor del elemento actual.
index Opcional. El índice del elemento actual.
arr Opcional. El objeto array al que pertenece el elemento actual.
thisValue Opcional. Objeto que se usa como `this` al ejecutar la función de devolución de llamada; se pasa a la función.
Si se omite `thisValue`, o se pasa `null` o `undefined`, el `this` de la función de devolución de llamada será el objeto global.

Detalles técnicos

Valor de retorno: Devuelve un nuevo array cuyos elementos son los valores obtenidos al llamar a la función sobre los elementos del array original.
Versión de JavaScript: 1.6

Más ejemplos

Ejemplo

Multiplica cada elemento del array por el valor especificado en el campo de entrada y devuelve un nuevo array:

var numbers = [65, 44, 12, 4];

function multiplyArrayElement(num) {
    return num * document.getElementById("multiplyWith").value;
}

function myFunction() {
    document.getElementById("demo").innerHTML = numbers.map(multiplyArrayElement);
}

Pruébalo »

Array 对象参考手册Objeto Array de JavaScript

Otras extensiones