CKTIS / JavaScript
Object.groupBy: grupiranje iterable elemenata u objekt
Object.groupBy prolazi iterable, poziva callback za svaki element i vraća objekt bez prototipa s poljima grupa.
Verzija: ECMAScript 2024 onward; example target: Node.js 24.22.2
Sintaksa
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) dohvaća sinkroni iterator iz items. Za svaki element poziva callback s vrijednošću i indeksom koji raste od 0, zatim primjenjuje ToPropertyKey na rezultat. Ključ može ostati tekst ili Symbol; drugi rezultati postaju tekstovi. Unutar grupa čuva se ulazni redoslijed.
Rezultat je novi objekt s prototipom null; svako vlastito svojstvo sadrži novo polje grupe. Zato je "__proto__" siguran običan ključ, ali nema metoda Object.prototype; ključeve provjeravaj npr. s Object.hasOwn. Za proizvoljne objektne ključeve umjesto property keys koristi Map.groupBy.
Metoda postoji od ECMAScript 2024. null, undefined, nedostatak iteratora ili nepozivljiv callback baca TypeError. Iznimke iteracije, callbacka ili pretvorbe ključa propagiraju se, a iterator se zatvara prema protokolu. Indeks od 2**53 - 1 također baca TypeError; beskonačni iterable ne završava sam.
Primjeri
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
Primjer grupira po tekstu, indeksu i Symbolu te pokazuje null prototip i siguran ključ __proto__.