Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła