CKTIS / JavaScript
Object.groupBy: Elemente eines Iterables in ein Objekt gruppieren
Object.groupBy iteriert ein Iterable, ruft je Element einen Callback auf und liefert ein prototyploses Objekt mit Gruppenarrays.
Version: ECMAScript 2024 onward; example target: Node.js 24.22.2
Syntax
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) holt einen synchronen Iterator aus items. Für jedes Element ruft es den Callback mit Wert und ab 0 steigendem Index auf und wendet ToPropertyKey auf das Ergebnis an. Ein Schlüssel kann String oder Symbol bleiben; andere Ergebnisse werden zu Strings. Innerhalb jeder Gruppe bleibt die Eingabereihenfolge erhalten.
Das Ergebnis ist ein neues Objekt mit Prototyp null; jede eigene Eigenschaft enthält ein neues Gruppenarray. Daher ist "__proto__" ein sicherer gewöhnlicher Schlüssel, doch Methoden von Object.prototype fehlen; Schlüssel prüft man etwa mit Object.hasOwn. Für beliebige Objektschlüssel statt Property Keys dient Map.groupBy.
Die Methode existiert seit ECMAScript 2024. null, undefined, ein fehlender Iterator oder nicht aufrufbarer Callback wirft TypeError. Ausnahmen aus Iteration, Callback oder Schlüsselkonvertierung werden nach protokollgemäßem Schließen des Iterators weitergereicht. Ein Index ab 2**53 - 1 wirft ebenfalls TypeError; ein unendliches Iterable endet nicht von selbst.
Beispiele
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]);Ergebnis
true A B,D C true x
Das Beispiel gruppiert nach Strings, Index und Symbol und zeigt Null-Prototyp sowie sicheren __proto__-Schlüssel.