Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.flatMap: mapear y aplanar un nivel

flatMap transforma elementos existentes y expande exactamente un nivel los arrays devueltos por el callback.

Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxis

array.flatMap(callbackFn[, thisArg])

array.flatMap(callbackFn[, thisArg]) llama a callbackFn(value, index, array) para índices existentes y expande cada resultado Array un nivel en un array nuevo. Un resultado no Array queda como un elemento; anidamiento más profundo y objetos array-like normales no se aplanan más.

La longitud inicial se guarda, los huecos se omiten y el resultado superficial respeta species. El callback puede devolver [] para omitir o varios valores para expandir. Callback no invocable o receptor null/undefined lanza TypeError; las excepciones se propagan. No espera una Promise devuelta. El ejemplo omite un hueco y emite dos valores por visita.

Ejemplos

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

Fuentes