Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje