WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.flat: verschachtelte Arrays abflachen

flat liefert ein neues flaches Array und breitet verschachtelte Arrays bis zur gewünschten Tiefe aus.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.flat([depth])

array.flat([depth]) erzeugt ein neues Array und breitet Array-Elemente bis depth aus; Standard ist 1. Das Argument wird zur Ganzzahl abgeschnitten: nicht positive Werte ergeben eine flache Kopie, Infinity vollständiges Abflachen. Ein array-ähnliches Nicht-Array wird nicht ausgebreitet.

Die Quelle wird nicht mutiert und Objekt-Referenzen bleiben gemeinsam. Lücken in besuchten Ebenen werden übersprungen, daher kann das Ergebnis dichter sein. Der Species-Konstruktor wird beachtet; Getter- und Proxyfehler werden weitergegeben. Empfänger null oder undefined löst TypeError aus. Das Beispiel flacht zwei Ebenen ab, entfernt deren Lücken und erhält die Quelllänge.

Beispiele

const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);

Ergebnis

1,2,3 3
3

Quellen