Array.prototype.flatMap()

Experimente

const arr1 = [1, 2, 1];

const result = arr1.flatMap((num) => (num === 2 ? [2, 2] : 1));

console.log(result);
// Expected output: Array [1, 2, 2, 1]

Sintaxe

var new_array = arr.flatMap(function callback(currentValue[, index[, array]]) {
    // retorna o elemento para new_array
}[, thisArg])

Parmetros

callback

Funo que produz um elemento de uma nova Array, pegando trs argumentos:

currentValue

O valor atual sendo processo na array.

indexOptional

O index do valor atual sendo processo na array.

arrayOptional

O map da array que foi chamado.

thisArgOptional

Valor para ser usado como this quando callback estiver sendo executado.

Valor de retorno

Uma nova array com cada elemento sendo o resultado da funo callback e achatado ao valor de 1.

Descrio

Veja Array.prototype.map() para uma detalhada descrio da funo callback. O mtodo flatMap idntico ao map seguido por um chamado a flatten de profundidade 1.

Exemplos

map e flatMap

var arr1 = [1, 2, 3, 4];

arr1.map((x) => [x * 2]);
// [[2], [4], [6], [8]]

arr1.flatMap((x) => [x * 2]);
// [2, 4, 6, 8]

//  S o primeiro nvel
arr1.flatMap((x) => [[x * 2]]);
// [[2], [4], [6], [8]]

Enquanto que acima poderamos alcanar apenas com a utilizao de map, j aqui temos um exemplo onde flatMap mais apropriado.

Vamos gerar uma lista de palavras a partir de uma lista de sentenas.

let arr1 = ["it's Sunny in", "", "California"];

arr1.map((x) => x.split(" "));
// [["it's","Sunny","in"],[""],["California"]]

arr1.flatMap((x) => x.split(" "));
// ["it's","Sunny","in", "", "California"]

Perceba, o comprimento da lista de sada pode ser diferente do comprimento da lista de entrada.

Alternativa

reduce e concat

var arr1 = [1, 2, 3, 4];
arr1.flatMap((x) => [x * 2]);
//  equivalente a
arr1.reduce((acc, x) => acc.concat([x * 2]), []);
// [ 2, 4, 6, 8 ]

Especificaes

Compatibilidade com navegadores

Veja tambm

• Array.prototype.flatten()
• Array.prototype.map()
• Array.prototype.reduce()
• Array.prototype.concat()