CKTIS / JavaScript
Array.prototype.flat: geneste arrays afvlakken
flat retourneert een nieuwe ondiepe array en spreidt geneste arrays tot de gevraagde diepte.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.flat([depth])array.flat([depth]) maakt een nieuwe array en spreidt Array-elementen tot depth; standaard is 1. Het argument wordt tot een geheel getal afgekapt: een niet-positieve waarde maakt een ondiepe kopie, Infinity volledige afvlakking. Een array-achtig object dat geen Array is wordt niet gespreid.
De bron muteert niet en objectverwijzingen blijven gedeeld. Gaten op bezochte niveaus worden overgeslagen, zodat het resultaat dichter kan zijn. De species-constructor wordt gevolgd; getter- en proxyfouten worden doorgegeven. Ontvanger null of undefined werpt TypeError. Het voorbeeld vlakt twee niveaus af, verwijdert hun gaten en behoudt de bronlengte.
Voorbeelden
const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);Resultaat
1,2,3 3 3