JavaScript Array flatMap()
- Página anterior flat()
- Próxima página forEach()
- Voltar para o nível superior Manual de Referência JavaScript Array
Definição e uso
flatMap()
O método executa operações de mapeamento em cada elemento do array e cria um novo array plano.
flatMap()
Cria um novo array através de chamadas de função para cada elemento do array.
flatMap()
Não executa a função para elementos de array vazios.
flatMap()
Não muda o array original.
Veja também:
Exemplo
const myArr = [1, 2, 3, 4, 5, 6]; const newArr = myArr.flatMap(x => [x, x * 10]);
Sintaxe
array.flatMap(function(currentValue, index, arr) thisValue)
Parâmetros
Parâmetros | Descrição |
---|---|
function() | Obrigatório. A função executada para cada elemento do array. |
currentValue | Obrigatório. O valor do elemento atual. |
index | Opcional. O índice do elemento atual. |
arr | Opcional. O array ao qual o elemento atual pertence. |
thisValue |
Opcional. O valor this passado para a função. O valor padrão é undefined. |
Retorno
Tipo | Descrição |
---|---|
Array | Array, que contém elementos de resultado de função de callback e os torna planos. |
Suporte do navegador
A partir de janeiro de 2020, todos os navegadores modernos suportam arrays JavaScript flatMap()
Método:
Chrome | Edge | Firefox | Safari | Opera |
---|---|---|---|---|
Chrome 69 | Edge 79 | Firefox 62 | Safari 12 | Opera 56 |
Setembro de 2018 | Janeiro de 2020 | Setembro de 2018 | Setembro de 2018 | Setembro de 2018 |
- Página anterior flat()
- Próxima página forEach()
- Voltar para o nível superior Manual de Referência JavaScript Array