O método JavaScript Array flatMap () primeiro mapeia cada elemento usando uma função de mapeamento e, em seguida, nivela-o em uma nova matriz.
A sintaxe do flatMap()
método é:
arr.flatMap(callback(currentValue),thisArg)
Aqui, arr é um array.
Parâmetros flatMap ()
O flatMap()
método inclui:
- retorno de chamada - a função a ser executada inicialmente em cada elemento da matriz. Inclui:
- currentValue - O elemento atual que está sendo passado da matriz.
- thisArg (opcional) - Valor a ser usado
this
na execuçãocallback
.
Valor de retorno de flatMap ()
- Retorna uma nova matriz após mapear cada elemento usando
callback
e nivelando-o a uma profundidade de 1 .
Notas :
- O
flatMap()
método não altera a matriz original. - O
flatMap()
método é equivalente aarray.map().flat()
.
Exemplo: Usando o método flatMap ()
const arr1 = (1, 2, 3, 4, 5); const newArr1 = arr1.flatMap((x) => (x ** 2)); console.log(newArr1); // ( 1, 2, 3, 4, 5 ) // can also be done as const intermediate = arr1.map((x) => (x ** 2)); console.log(intermediate); // ( ( 1 ), ( 4 ), ( 9 ), ( 16 ), ( 25 ) ) const newArr2 = intermediate.flat(); console.log(newArr2); // ( 1, 4, 9, 16, 25 ) const numbers = (1, 2, 3, 4, 5, 6, 7); // remove odd and split even element to two half elements function func(n) ( if (n % 2 === 0) ( return (n / 2, n / 2); ) else ( return (); ) ) const newArr3 = numbers.flatMap(func); console.log(newArr3); // ( 1, 1, 2, 2, 3, 3 )
Resultado
(1, 4, 9, 16, 25) ((1), (4), (9), (16), (25)) (1, 4, 9, 16, 25) (1, 1, 2, 2, 3, 3)
Leitura recomendada: JavaScript Array flat ()