Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.flatMap: mappare e appiattire un livello

flatMap trasforma gli elementi esistenti ed espande di un solo livello gli array restituiti dal callback.

Versione: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintassi

array.flatMap(callbackFn[, thisArg])

array.flatMap(callbackFn[, thisArg]) chiama callbackFn(value, index, array) per gli indici esistenti ed espande ogni risultato Array di un livello in un nuovo array. Un risultato non Array resta un elemento; annidamenti più profondi e oggetti array-like normali non vengono ulteriormente appiattiti.

La lunghezza iniziale è acquisita, i vuoti saltati e il risultato superficiale rispetta species. Il callback può restituire [] per omettere o più valori per espandere. Callback non invocabile o ricevente null/undefined genera TypeError; le eccezioni si propagano. Non attende una Promise restituita. L’esempio salta un vuoto ed emette due valori per visita.

Esempi

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

Risultato

1,10,2,20
2

Fonti