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