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