CKTIS / JavaScript
Array.prototype.flat: sploštenie vnorených polí
flat vracia nové plytké pole a rozbalí vnorené polia do požadovanej hĺbky.
Verzia: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.flat([depth])array.flat([depth]) vytvorí nové pole a rozbalí prvky Array do depth; predvolená hodnota je 1. Argument sa oreže na celé číslo: nekladná hodnota vytvorí plytkú kópiu, Infinity úplné sploštenie. Array-like objekt, ktorý nie je Array, sa nerozbalí.
Zdroj sa nemení a referencie objektov zostanú zdieľané. Diery na navštívených úrovniach sa preskočia, takže výsledok môže byť hustejší. Rešpektuje species konštruktor; chyby getterov či proxy sa šíria. Prijímateľ null alebo undefined vyvolá TypeError. Príklad sploští dve úrovne, odstráni ich diery a zachová dĺžku zdroja.
Príklady
const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);Výsledok
1,2,3 3 3