CKTIS / JavaScript
Array.prototype.flat : aplatir les tableaux imbriqués
flat renvoie un nouveau tableau superficiel en étalant les tableaux imbriqués jusqu’à la profondeur demandée.
Version : ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
array.flat([depth])array.flat([depth]) crée un nouveau tableau et étale les éléments Array jusqu’à depth, égal à 1 par défaut. L’argument est tronqué en entier : une valeur non positive produit une copie superficielle, Infinity un aplatissement complet. Un objet array-like qui n’est pas Array n’est pas étalé.
La source n’est pas modifiée et les références restent partagées. Les trous des niveaux visités sont ignorés, donc le résultat peut être plus dense. Le constructeur species est respecté ; les erreurs de getter ou proxy se propagent. Un receveur null ou undefined lève TypeError. L’exemple aplatit deux niveaux, retire leurs trous et conserve la longueur source.
Exemples
const source = [1, , [2, , [3]]];
const result = source.flat(2);
console.log(result.join(","), result.length);
console.log(source.length);Résultat
1,2,3 3 3