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

CKTIS / JavaScript

Map.groupBy : regrouper un itérable dans une Map

Map.groupBy parcourt un itérable, calcule une clé pour chaque élément et renvoie une Map dont les valeurs sont des tableaux conservant l’ordre d’entrée.

Version : ECMAScript 2024 onward; example target: Node.js 24.22.2

Syntaxe

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) consomme les éléments de tout itérable. Pour chacun, elle appelle callbackFn(value, index), avec un index commençant à 0, puis ajoute la valeur au tableau associé à la clé renvoyée. Le résultat est une nouvelle Map ordinaire ; l’ordre des clés suit leur première occurrence et chaque groupe conserve l’ordre d’itération.

Contrairement à Object.groupBy, toute valeur peut servir de clé, y compris un objet sans conversion en chaîne. Les clés suivent SameValueZero : NaN se regroupe avec NaN, tandis que -0 et +0 forment un seul groupe représenté par +0. Les éléments ne sont ni copiés ni clonés ; les tableaux gardent les mêmes valeurs et références d’objet que l’entrée.

Des items non itérables, null/undefined ou un callback non appelable lèvent TypeError ; une exception du callback se propage et l’itérateur actif est fermé. La méthode est standard depuis ECMAScript 2024. Utilisez-la lorsque les clés doivent conserver l’identité des objets ; pour des clés chaînes sûres, Object.groupBy peut convenir.

Exemples

const engineering = { name: "Engineering" };
const support = { name: "Support" };
const people = [
  { name: "Ada", department: engineering },
  { name: "Lin", department: support },
  { name: "Grace", department: engineering },
];

const byDepartment = Map.groupBy(people, (person) => person.department);
for (const [department, members] of byDepartment) {
  console.log(department.name, members.map(({ name }) => name).join(","));
}
console.log(byDepartment.get(engineering)[0] === people[0]);

const special = Map.groupBy([-0, 0, NaN, NaN], (value) => value);
console.log(special.size, special.get(0).length, special.get(NaN).length);
console.log(Object.is([...special.keys()][0], 0));

Résultat

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Sources