KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Object.groupBy: iterabele elementen in een object groeperen

Object.groupBy doorloopt een iterable, roept per element een callback aan en retourneert een null-prototypeobject met groepsarrays.

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

Syntax

Object.groupBy(items, callbackFn)

Object.groupBy(items, callbackFn) haalt een synchrone iterator uit items. Per element roept het de callback aan met waarde en een vanaf 0 oplopende index, en past ToPropertyKey toe op het resultaat. Een sleutel kan string of Symbol blijven; andere resultaten worden strings. Binnen elke groep blijft de invoervolgorde behouden.

Het resultaat is een nieuw object met prototype null; elke eigen eigenschap bevat een nieuwe groepsarray. Daardoor is "__proto__" een veilige gewone sleutel, maar ontbreken methoden van Object.prototype; test sleutels bijvoorbeeld met Object.hasOwn. Gebruik Map.groupBy wanneer willekeurige objectsleutels onderscheiden moeten blijven.

De methode bestaat sinds ECMAScript 2024. null, undefined, een ontbrekende iterator of niet-aanroepbare callback geeft TypeError. Excepties uit iteratie, callback of sleutelconversie worden doorgegeven en de iterator wordt volgens het protocol gesloten. Een index vanaf 2**53 - 1 geeft ook TypeError; een oneindige iterable stopt niet vanzelf.

Voorbeelden

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

Resultaat

true
A
B,D
C
true x

Het voorbeeld groepeert op strings, index en Symbol en toont null-prototype en veilige __proto__-sleutel.

Bronnen