CKTIS / JavaScript
Array.prototype.flatMap: mapování a zploštění jedné úrovně
flatMap mapuje existující prvky a pole vrácená callbackem rozbalí přesně o jednu úroveň.
Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
array.flatMap(callbackFn[, thisArg])array.flatMap(callbackFn[, thisArg]) volá callbackFn(value, index, array) pro existující indexy a každý výsledek Array rozbalí o jednu úroveň do nového pole. Výsledek, který není Array, zůstane jedním prvkem; hlubší vnoření a běžné array-like objekty se dál nezplošťují.
Počáteční délka se uloží, díry přeskočí a mělký výsledek respektuje species. Callback může vrátit [] pro vynechání nebo více hodnot pro rozšíření. Nevolatelný callback nebo příjemce null/undefined vyvolá TypeError; výjimky se šíří. Vrácenou Promise nečeká. Příklad přeskočí díru a vytvoří dvě hodnoty na návštěvu.
Příklady
const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);Výsledek
1,10,2,20 2