WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen