WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen