CKTIS / JavaScript
Array.prototype.flat: spłaszczanie zagnieżdżonych tablic
flat zwraca nową płytką tablicę, rozwijając tablice zagnieżdżone do zadanej głębokości.
Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2
Składnia
array.flat([depth])array.flat([depth]) tworzy nową tablicę i rozwija elementy będące tablicami do depth; domyślnie depth wynosi 1. Argument jest obcinany do liczby całkowitej: wartość niedodatnia daje płytką kopię, a Infinity pełne spłaszczenie. Obiekt array-like, który nie jest tablicą, nie zostaje rozwinięty.
Źródło nie jest mutowane, a referencje obiektów pozostają wspólne. Dziury na odwiedzanych poziomach są pomijane, więc wynik może być gęstszy. Wynik respektuje konstruktor species; błędy getterów i proxy są przekazywane. Odbiorca null lub undefined powoduje TypeError. Przykład spłaszcza dwa poziomy, usuwa ich dziury i zachowuje długość źródła.
Przykłady
const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);Wynik
1,2,3 3 3