CKTIS / JavaScript
Object.groupBy: združevanje elementov iterable v objekt
Object.groupBy prehodi iterable, za vsak element pokliče callback in vrne objekt brez prototipa s polji skupin.
Različica: ECMAScript 2024 onward; example target: Node.js 24.22.2
Sintaksa
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) pridobi sinhroni iterator iz items. Za vsak element pokliče callback z vrednostjo in indeksom, ki raste od 0, nato na rezultat uporabi ToPropertyKey. Ključ lahko ostane niz ali Symbol; drugi rezultati postanejo nizi. V vsaki skupini se ohrani vhodni vrstni red.
Rezultat je nov objekt s prototipom null; vsaka lastna lastnost vsebuje novo polje skupine. Zato je "__proto__" varen navaden ključ, vendar metod Object.prototype ni; ključe preverjaj na primer z Object.hasOwn. Za poljubne objektne ključe namesto property keys uporabi Map.groupBy.
Metoda obstaja od ECMAScript 2024. null, undefined, manjkajoči iterator ali neklicljiv callback sproži TypeError. Izjeme iteracije, callbacka ali pretvorbe ključa se razširijo, iterator pa se po protokolu zapre. Indeks od 2**53 - 1 prav tako sproži TypeError; neskončni iterable se sam ne konča.
Primeri
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]);Rezultat
true A B,D C true x
Primer združuje po nizih, indeksu in Symbol ter pokaže ničelni prototip in varen ključ __proto__.