CKTIS / JavaScript
Array.prototype.flatMap: abbilden und eine Ebene abflachen
flatMap bildet vorhandene Elemente ab und breitet Callback-Arrays genau eine Ebene aus.
Version: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.flatMap(callbackFn[, thisArg])array.flatMap(callbackFn[, thisArg]) ruft callbackFn(value, index, array) für vorhandene Indizes auf und breitet jedes Array-Ergebnis eine Ebene in ein neues Array aus. Ein Nicht-Array bleibt ein Element; tiefere Verschachtelung und gewöhnliche array-ähnliche Objekte werden nicht weiter abgeflacht.
Die Quelllänge wird anfangs gespeichert, Lücken werden übersprungen und das flache Ergebnis beachtet species. Der Callback kann [] zum Weglassen oder mehrere Werte zum Erweitern liefern. Nicht aufrufbarer Callback oder Empfänger null/undefined löst TypeError aus; Ausnahmen werden weitergegeben. Eine zurückgegebene Promise wird nicht erwartet. Das Beispiel überspringt eine Lücke und erzeugt je zwei Werte.
Beispiele
const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);Ergebnis
1,10,2,20 2