Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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__.

Izvori