JavaScript Array flatMap()

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:

Método map() do Array

Método flat() do Array

Método filter() do Array

Método forEach() do Array

Exemplo

const myArr = [1, 2, 3, 4, 5, 6];
const newArr = myArr.flatMap(x => [x, x * 10]);

Experimente você mesmo

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