Mapa de matriz JavaScript()
Exemplos
Retorne um novo array com a raiz quadrada de todos os valores dos elementos:
const numbers = [4, 9, 16, 25];
const newArr = numbers.map(Math.sqrt)
Multiplique todos os valores em uma matriz por 10:
const numbers = [65, 44, 12, 4];
const newArr = numbers.map(myFunction)
function myFunction(num) {
return num * 10;
}
Mais exemplos abaixo.
Definição e uso
map()
cria uma nova matriz chamando uma função para cada elemento da matriz.
map()
chama uma função uma vez para cada elemento em uma matriz.
map()
não executa a função para elementos vazios.
map()
não altera a matriz original.
Sintaxe
array.map(function(currentValue, index, arr), thisValue)
Parâmetros
Parameter | Description |
function() | Required. A function to be run for each array element. |
currentValue | Required. The value of the current element. |
index | Optional. The index of the current element. |
arr | Optional. The array of the current element. |
thisValue | Optional. Default value undefined .A value passed to the function to be used as its this value. |
Valor de retorno
Modelo | Descrição |
Uma matriz | Os resultados de uma função para cada elemento da matriz. |
Suporte ao navegador
map()
é um recurso ECMAScript5 (ES5).
ES5 (JavaScript 2009) totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |
Mais exemplos
Obtenha o nome completo de cada pessoa:
const persons = [
{firstname : "Malcom", lastname: "Reynolds"},
{firstname : "Kaylee", lastname: "Frye"},
{firstname : "Jayne", lastname: "Cobb"}
];
persons.map(getFullName);
function getFullName(item) {
return [item.firstname,item.lastname].join(" ");
}