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