WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.groupBy: iterierbare Daten in einer Map gruppieren

Map.groupBy durchläuft ein Iterable, berechnet für jedes Element einen Schlüssel und liefert eine Map mit Arrays in Eingabereihenfolge als Werten.

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

Syntax

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) liest Elemente aus jedem Iterable. Für jedes ruft es callbackFn(value, index) mit einem bei 0 beginnenden Index auf und hängt den Wert an das Array des zurückgegebenen Schlüssels an. Ergebnis ist eine neue gewöhnliche Map; die Schlüsselreihenfolge folgt dem ersten Auftreten, die Werte jeder Gruppe behalten die Iterationsreihenfolge.

Anders als bei Object.groupBy kann jeder Wert Schlüssel sein, auch ein Objekt ohne Zeichenkettenumwandlung. Schlüssel verwenden SameValueZero: NaN gruppiert sich mit NaN, -0 und +0 bilden eine durch +0 dargestellte Gruppe. Elemente werden weder kopiert noch geklont; Gruppenarrays enthalten dieselben Werte und Objektreferenzen wie die Eingabe.

Nicht iterierbare items, null/undefined oder ein nicht aufrufbarer Callback lösen TypeError aus; eine Callback-Ausnahme wird weitergereicht und der aktive Iterator geschlossen. Die Methode ist seit ECMAScript 2024 Standard. Sie eignet sich, wenn Objektschlüssel ihre Identität behalten müssen; für sichere Zeichenkettenschlüssel kann Object.groupBy passen.

Beispiele

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));

Ergebnis

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Quellen