Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources