Array.prototype.flat()

Die flat() Methode erstellt rekursiv ein neues Array mit allen Elementen von Unterarrays bis zu einer spezifizierten Tiefe.

{{EmbedInteractiveExample("pages/js/array-flatten.html")}}

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Syntax

var newArray = arr.flat(depth);

Parameter

depth Optional

Das Tiefenlevel, welches angibt, bis zu welcher Tiefe die Arraystruktur abgeflacht werden soll. Der Standardwert ist 1.

Rückgabewert

Ein neues Array, welches die Elemente der Unterarrays enthält.

Beispiele

Abflachen von geschachtelten Arrays

var arr1 = [1, 2, [3, 4]];
arr1.flat();
// [1, 2, 3, 4]

var arr2 = [1, 2, [3, 4, [5, 6]]];
arr2.flat();
// [1, 2, 3, 4, [5, 6]]

var arr3 = [1, 2, [3, 4, [5, 6]]];
arr3.flat(2);
// [1, 2, 3, 4, 5, 6]

Abflachen und Löcher in Arrays

Die flat Methode entfernt leere Plätze in Arrays:

var arr4 = [1, 2, , 4, 5];
arr4.flat();
// [1, 2, 4, 5]

Alternative

reduce und concat

var arr1 = [1, 2, [3, 4]];
arr1.flat();

// Um ein Array um eine Ebene zu glätten.
arr1.reduce((acc, val) => acc.concat(val), []);
// [1, 2, 3, 4]

// Um mehrere Ebenen zu glätten muss reduce und concat rekursiv eingesetzt werden.

var arr1 = [1,2,3,[1,2,3,4, [2,3,4]]];

function flattenDeep(arr1) {
   return arr1.reduce((acc, val) => Array.isArray(val) ? acc.concat(flattenDeep(val)) : acc.concat(val), []);
}
flattenDeep(arr1);

// [1, 2, 3, 1, 2, 3, 4, 2, 3, 4]

Spezifikationen

Browserkompatibilität

Siehe auch

• Array.prototype.flatMap()
• Array.prototype.map()
• Array.prototype.reduce()
• Array.prototype.concat()