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

CKTIS / JavaScript

Array.prototype.flatMap : transformer puis aplatir un niveau

flatMap transforme les éléments existants et étale sur exactement un niveau les tableaux renvoyés.

Version : ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.flatMap(callbackFn[, thisArg])

array.flatMap(callbackFn[, thisArg]) appelle callbackFn(value, index, array) pour les indices existants et étale chaque résultat Array sur un niveau dans un nouveau tableau. Un résultat non Array reste un élément ; les imbrications plus profondes et objets array-like ordinaires ne sont pas davantage aplatis.

La longueur source est mémorisée, les trous ignorés et le résultat superficiel respecte species. Le callback peut renvoyer [] pour omettre ou plusieurs valeurs pour développer. Callback non appelable ou receveur null/undefined lève TypeError; les exceptions se propagent. Une Promise renvoyée n’est pas attendue. L’exemple ignore un trou et émet deux valeurs par visite.

Exemples

const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);

Résultat

1,10,2,20
2

Sources