CKTIS / JavaScript
Array.prototype.flat: spljoštavanje ugniježđenih polja
flat vraća novo plitko polje i širi ugniježđena polja do zadane dubine.
Verzija: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaksa
array.flat([depth])array.flat([depth]) stvara novo polje i širi Array elemente do depth; zadana vrijednost je 1. Argument se odbacivanjem decimala pretvara u cijeli broj: nepozitivna vrijednost daje plitku kopiju, Infinity potpuno spljoštavanje. Array-like objekt koji nije Array ne širi se.
Izvor se ne mijenja i reference objekata ostaju dijeljene. Prazna mjesta na posjećenim razinama preskaču se, pa rezultat može biti gušći. Poštuje species konstruktor; pogreške gettera ili proxyja šire se. Primatelj null ili undefined baca TypeError. Primjer spljoštava dvije razine, uklanja prazna mjesta i čuva duljinu izvora.
Primjeri
const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);Rezultat
1,2,3 3 3