CKTIS / JavaScript
Object.groupBy: zoskupenie prvkov iterable do objektu
Object.groupBy prejde iterable, pre každý prvok zavolá callback a vráti objekt bez prototypu s poľami skupín.
Verzia: ECMAScript 2024 onward; example target: Node.js 24.22.2
Syntax
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) získa synchrónny iterátor z items. Pre každý prvok volá callback s hodnotou a indexom rastúcim od 0 a na výsledok použije ToPropertyKey. Kľúčom tak môže zostať reťazec alebo Symbol; iné výsledky sa prevedú na reťazce. V skupinách sa zachová vstupné poradie.
Výsledkom je nový objekt s prototypom null; každá vlastná vlastnosť obsahuje nové pole skupiny. Preto je "__proto__" bezpečný bežný kľúč, ale chýbajú metódy Object.prototype; kľúče testujte napríklad cez Object.hasOwn. Pre ľubovoľné objektové kľúče namiesto property keys použite Map.groupBy.
Metóda existuje od ECMAScript 2024. null, undefined, chýbajúci iterátor alebo nevolateľný callback vyvolá TypeError. Výnimky iterácie, callbacku či prevodu kľúča sa šíria a iterátor sa podľa protokolu zavrie. Index od 2**53 - 1 tiež vyvolá TypeError; nekonečné iterable samo neskončí.
Príklady
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]);Výsledok
true A B,D C true x
Príklad zoskupuje podľa reťazcov, indexu a Symbol a ukazuje nulový prototyp aj bezpečný kľúč __proto__.