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

CKTIS / JavaScript

Object.groupBy : grouper un itérable dans un objet

Object.groupBy parcourt un itérable, appelle un callback pour chaque élément et renvoie un objet sans prototype contenant les tableaux de groupes.

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

Syntaxe

Object.groupBy(items, callbackFn)

Object.groupBy(items, callbackFn) obtient l’itérateur synchrone de items. Pour chaque élément, il appelle le callback avec la valeur et un indice croissant depuis 0, puis applique ToPropertyKey au résultat. Une clé peut donc rester chaîne ou Symbol ; les autres résultats deviennent des chaînes. L’ordre d’entrée est conservé dans chaque groupe.

Le résultat est un nouvel objet de prototype null, dont chaque propriété propre contient un nouveau tableau de groupe. Ainsi "__proto__" est une clé ordinaire sûre, mais les méthodes de Object.prototype manquent ; utilisez par exemple Object.hasOwn. Pour conserver des clés objets arbitraires plutôt que des property keys, choisissez Map.groupBy.

La méthode existe depuis ECMAScript 2024. null, undefined, l’absence d’itérateur ou un callback non appelable lève TypeError. Les exceptions de l’itération, du callback ou de la conversion de clé se propagent avec fermeture réglementaire de l’itérateur. Un indice au moins égal à 2**53 - 1 lève aussi TypeError ; un itérable infini ne finit pas seul.

Exemples

const urgent = Symbol("urgent");
const tasks = [
  { name: "A", urgent: false },
  { name: "B", urgent: false },
  { name: "C", urgent: true },
  { name: "D", urgent: false }
];
const groups = Object.groupBy(tasks, (task, index) =>
  task.urgent ? urgent : (index % 2 === 0 ? "now" : "later")
);
console.log(Object.getPrototypeOf(groups) === null);
console.log(groups.now.map(task => task.name).join(","));
console.log(groups.later.map(task => task.name).join(","));
console.log(groups[urgent].map(task => task.name).join(","));

const safe = Object.groupBy(["x"], () => "__proto__");
console.log(Object.getPrototypeOf(safe) === null, safe.__proto__[0]);

Résultat

true
A
B,D
C
true x

L’exemple groupe par chaînes, indice et Symbol, puis montre le prototype nul et la clé __proto__ sûre.

Sources