CKTIS / JavaScript
Array.prototype.flatMap: mapowanie i spłaszczenie jednego poziomu
flatMap mapuje istniejące elementy i rozwija tablice zwrócone przez callback dokładnie o jeden poziom.
Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2
Składnia
array.flatMap(callbackFn[, thisArg])array.flatMap(callbackFn[, thisArg]) wywołuje callbackFn(value, index, array) dla istniejących indeksów, a każdy wynik będący tablicą rozwija o jeden poziom do nowej tablicy. Wartość niebędąca tablicą pozostaje jednym elementem; głębsze zagnieżdżenie i zwykłe obiekty array-like nie są dalej rozwijane.
Długość źródła jest zapamiętywana na początku, dziury są pomijane, a wynik jest płytki i respektuje species. Callback może zwrócić [], aby pominąć element, albo tablicę wielu wartości, aby go rozszerzyć. Callback niebędący funkcją lub odbiorca null/undefined powoduje TypeError; wyjątki są przekazywane. Metoda nie czeka na Promise z callbacku. Przykład pomija dziurę i tworzy po dwie wartości.
Przykłady
const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);Wynik
1,10,2,20 2