KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen