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

CKTIS / JavaScript

Array.prototype.flatMap: mapear e achatar um nível

flatMap mapeia elementos existentes e expande exatamente um nível dos arrays devolvidos pelo callback.

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

Sintaxe

array.flatMap(callbackFn[, thisArg])

array.flatMap(callbackFn[, thisArg]) chama callbackFn(value, index, array) para índices existentes e expande cada resultado Array um nível num array novo. Um resultado não Array permanece um elemento; aninhamento mais profundo e objetos array-like normais não são novamente achatados.

O comprimento inicial é guardado, posições vazias são ignoradas e o resultado superficial respeita species. O callback pode devolver [] para omitir ou vários valores para expandir. Callback não invocável ou recetor null/undefined lança TypeError; exceções propagam-se. Não espera uma Promise devolvida. O exemplo ignora uma posição vazia e emite dois valores por visita.

Exemplos

const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);

Resultado

1,10,2,20
2

Fontes