O método JavaScript Array flat () cria uma nova matriz com todos os elementos da submatriz concatenados nela recursivamente até a profundidade especificada.
A sintaxe do flat()método é:
arr.flat(depth)
Aqui, arr é um array.
Parâmetros flat ()
O flat()método inclui:
- profundidade (opcional) - Número inteiro que especifica a profundidade que uma matriz aninhada deve ser nivelada. Seu valor padrão é 1 .
Valor de retorno de plano ()
- Retorna uma nova matriz com os elementos da submatriz concatenados nela.
Notas :
- O
flat()método não altera a matriz original. - O
flat()método remove slots vazios em arrays.
Exemplo: usando o método flat ()
const arr1 = (1, (2, 3, 4), 5); const flattened1 = arr1.flat(); console.log(flattened1); // ( 1, 2, 3, 4, 5 ) const arr2 = (1, 2, (3, 4, (5, 6))); const flattened2 = arr2.flat(); console.log(flattened2); // (1, 2, 3, 4, (5, 6)) const flattened3 = arr2.flat(2); console.log(flattened3); // ( 1, 2, 3, 4, 5, 6 ) const arr4 = (1, 2, (3, 4, (5, 6, (7, 8, (9, 10))))); const flattened4 = arr4.flat(Infinity); console.log(flattened4); // ( 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ) // flat() removes holes const numArr = (1, , 3); console.log(numArr.flat()); // ( 1, 3 )
Resultado
(1, 2, 3, 4, 5) (1, 2, 3, 4, (5, 6)) (1, 2, 3, 4, 5, 6) (1, 2, 3, 4, 5, 6, 7, 8, 9, 10) (1, 3)
Conforme mostrado no exemplo, podemos usar Infinitypara nivelar recursivamente a matriz em qualquer profundidade.
Leitura recomendada: JavaScript Array flatMap ()
