Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.flat: achatar arrays aninhados

flat devolve um array superficial novo, expandindo arrays aninhados até à profundidade pedida.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.flat([depth])

array.flat([depth]) cria um array novo e expande elementos Array até depth, que é 1 por omissão. O argumento é truncado para inteiro: um valor não positivo produz uma cópia superficial, Infinity achatamento completo. Um objeto array-like que não seja Array não é expandido.

Não altera a fonte e as referências de objetos continuam partilhadas. Posições vazias nos níveis visitados são ignoradas, logo o resultado pode ser mais denso. Respeita o construtor species; erros de getters ou proxies propagam-se. Um recetor null ou undefined lança TypeError. O exemplo achata dois níveis, remove as posições vazias e conserva o comprimento da fonte.

Exemplos

const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);

Resultado

1,2,3 3
3

Fontes