CKTIS / JavaScript
Map.groupBy: raggruppare dati iterabili in una Map
Map.groupBy percorre un iterabile, calcola una chiave per ogni elemento e restituisce una Map i cui valori sono array che preservano l’ordine di input.
Versione: ECMAScript 2024 onward; example target: Node.js 24.22.2
Sintassi
Map.groupBy(items, callbackFn)Map.groupBy(items, callbackFn) consuma gli elementi di qualsiasi iterabile. Per ognuno chiama callbackFn(value, index), con indice iniziale 0, e aggiunge il valore all’array della chiave restituita. Il risultato è una nuova Map ordinaria; l’ordine delle chiavi segue la prima occorrenza e i valori in ogni gruppo mantengono l’ordine di iterazione.
A differenza di Object.groupBy, qualsiasi valore può essere una chiave, incluso un oggetto senza conversione in stringa. Le chiavi usano SameValueZero: NaN si raggruppa con NaN, mentre -0 e +0 formano un solo gruppo rappresentato da +0. Gli elementi non sono copiati né clonati; gli array dei gruppi conservano gli stessi valori e riferimenti agli oggetti dell’input.
items non iterabile, null/undefined o un callback non invocabile genera TypeError; un’eccezione del callback si propaga e l’iteratore attivo viene chiuso. Il metodo è standard da ECMAScript 2024. È adatto quando le chiavi devono mantenere l’identità degli oggetti; per chiavi stringa sicure può bastare Object.groupBy.
Esempi
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));Risultato
Engineering Ada,Grace Support Lin true 2 2 2 true