Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.flat: zploštění vnořených polí

flat vrací nové mělké pole a rozbalí vnořená pole do požadované hloubky.

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

Syntaxe

array.flat([depth])

array.flat([depth]) vytvoří nové pole a rozbalí prvky Array do depth; výchozí hodnota je 1. Argument se ořízne na celé číslo: nekladná hodnota vytvoří mělkou kopii, Infinity úplné zploštění. Array-like objekt, který není Array, se nerozbalí.

Zdroj se nemění a reference objektů zůstanou sdílené. Díry na navštívených úrovních se přeskočí, takže výsledek může být hustší. Respektuje species konstruktor; chyby getterů či proxy se šíří. Příjemce null nebo undefined vyvolá TypeError. Příklad zploští dvě úrovně, odstraní jejich díry a zachová délku zdroje.

Příklady

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

Výsledek

1,2,3 3
3

Zdroje