CKTIS / JavaScript
Object.groupBy: raggruppare elementi iterabili in un oggetto
Object.groupBy percorre un iterable, chiama un callback per elemento e restituisce un oggetto senza prototipo con array di gruppi.
Versione: ECMAScript 2024 onward; example target: Node.js 24.22.2
Sintassi
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) ottiene un iteratore sincrono da items. Per ogni elemento chiama il callback con valore e indice crescente da 0, poi applica ToPropertyKey al risultato. Una chiave può restare stringa o Symbol; gli altri risultati diventano stringhe. Ogni gruppo conserva l’ordine di input.
Il risultato è un nuovo oggetto con prototipo null; ogni proprietà propria contiene un nuovo array del gruppo. Quindi "__proto__" è una chiave ordinaria sicura, ma mancano i metodi di Object.prototype; usa per esempio Object.hasOwn. Per mantenere chiavi oggetto arbitrarie invece di property key, usa Map.groupBy.
Il metodo esiste da ECMAScript 2024. null, undefined, iteratore mancante o callback non invocabile genera TypeError. Le eccezioni di iterazione, callback o conversione della chiave si propagano con chiusura dell’iteratore secondo protocollo. Un indice da 2**53 - 1 genera anch’esso TypeError; un iterable infinito non termina da solo.
Esempi
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]);Risultato
true A B,D C true x
L’esempio raggruppa per stringhe, indice e Symbol e mostra prototipo nullo e chiave __proto__ sicura.