Método map: transformando cada item da lista

Aprenda a criar um novo array aplicando uma função a cada elemento do original.

O map é um método de array usado quando você quer pegar uma lista e criar outra lista transformada.

Pense assim:
você tem uma caixa com camisetas brancas (array original) e quer uma nova caixa com as mesmas camisetas tingidas de azul (array novo).
Você não destrói a caixa original — você cria uma nova versão transformada.

Para que serve o map?

Serve para aplicar uma transformação em cada item de um array, retornando um novo array com os resultados.

Sintaxe básica

const novoArray = arrayOriginal.map(function(item, indice) {
  return itemTransformado;
});
  • item: valor atual
  • indice (opcional): posição
  • return: valor transformado que vai para o novo array

Exemplo 1: dobrando números

const numeros = [1, 2, 3, 4];

const dobrados = numeros.map(function(numero) {
  return numero * 2;
});

console.log(dobrados); // [2, 4, 6, 8]
console.log(numeros);  // [1, 2, 3, 4]

Perceba: numeros continua igual. O map cria outra lista.

Exemplo 2: com Arrow Function (forma moderna)

const precos = [10, 20, 30];

const comDesconto = precos.map(preco => preco * 0.9);

console.log(comDesconto); // [9, 18, 27]

Exemplo 3: transformando textos

const nomes = ["ana", "carlos", "bia"];

const maiusculos = nomes.map(nome => nome.toUpperCase());

console.log(maiusculos); // ["ANA", "CARLOS", "BIA"]

Diferença rápida: forEach vs map

  • forEach: percorre para executar ações (ex.: imprimir no console).
  • map: percorre para gerar um novo array transformado.

Se você precisa de uma nova lista, pense em map.

Boas práticas com map

  • Sempre retorne algo no callback.
  • Use nomes claros (produto, preco, nome).
  • Evite lógica muito grande dentro do map; se necessário, extraia para função.
  • Lembre-se: o objetivo principal é transformação.

Resumo da lição

map transforma item por item de uma lista e devolve um novo array.
É uma das ferramentas mais úteis do JavaScript para trabalhar com dados de forma limpa, previsível e reutilizável.