CKTIS / JavaScript
Map.groupBy: iterabele gegevens in een Map groeperen
Map.groupBy doorloopt een iterable, berekent per element een sleutel en geeft een Map terug met arrays die de invoervolgorde bewaren.
Versie: ECMAScript 2024 onward; example target: Node.js 24.22.2
Syntax
Map.groupBy(items, callbackFn)Map.groupBy(items, callbackFn) verbruikt elementen uit elke iterable. Voor elk element roept het callbackFn(value, index) aan, met een index vanaf 0, en voegt de waarde toe aan de array voor de teruggegeven sleutel. Het resultaat is een nieuwe gewone Map; sleutelvolgorde volgt eerste voorkomen en waarden binnen elke groep behouden iteratievolgorde.
Anders dan bij Object.groupBy kan elke waarde sleutel zijn, ook een object zonder tekenreeksconversie. Sleutels gebruiken SameValueZero: NaN groepeert met NaN, terwijl -0 en +0 één door +0 vertegenwoordigde groep vormen. Elementen worden niet gekopieerd of gekloond; groepsarrays bevatten dezelfde waarden en objectreferenties als de invoer.
Niet-iterabele items, null/undefined of een niet-aanroepbare callback werpt TypeError; een callback-uitzondering wordt doorgegeven en de actieve iterator wordt gesloten. De methode is standaard sinds ECMAScript 2024. Kies haar wanneer sleutels objectidentiteit moeten bewaren; voor veilige tekenreekssleutels kan Object.groupBy geschikt zijn.
Voorbeelden
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));Resultaat
Engineering Ada,Grace Support Lin true 2 2 2 true