Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Map.groupBy: grupiranje iterabilnih podataka u Map

Map.groupBy prolazi iterable, računa ključ za svaki element i vraća Map s poljima vrijednosti koja čuvaju ulazni redoslijed.

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

Sintaksa

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) uzima elemente iz bilo kojeg iterable. Za svaki poziva callbackFn(value, index), s indeksom od 0, i dodaje vrijednost u polje vraćenog ključa. Rezultat je nova obična Map; redoslijed ključeva prati prvo pojavljivanje, a vrijednosti u svakoj grupi čuvaju redoslijed iteracije.

Za razliku od Object.groupBy, ključ može biti bilo koja vrijednost, uključujući objekt bez pretvorbe u niz. Ključevi koriste SameValueZero: NaN se grupira s NaN, dok -0 i +0 čine jednu grupu predstavljenu s +0. Elementi se ne kopiraju ni kloniraju; polja grupa drže iste vrijednosti i reference na objekte kao ulaz.

Neiterabilni items, null/undefined ili nepozivajući callback baca TypeError; iznimka callbacka širi se, a aktivni iterator se zatvara. Metoda je standardna od ECMAScript 2024. Odaberite je kada ključevi moraju čuvati identitet objekta; za sigurne nizovne ključeve može odgovarati Object.groupBy.

Primjeri

const engineering = { name: "Engineering" };
const support = { name: "Support" };
const people = [
  { name: "Ada", department: engineering },
  { name: "Lin", department: support },
  { name: "Grace", department: engineering },
];

const byDepartment = Map.groupBy(people, (person) => person.department);
for (const [department, members] of byDepartment) {
  console.log(department.name, members.map(({ name }) => name).join(","));
}
console.log(byDepartment.get(engineering)[0] === people[0]);

const special = Map.groupBy([-0, 0, NaN, NaN], (value) => value);
console.log(special.size, special.get(0).length, special.get(NaN).length);
console.log(Object.is([...special.keys()][0], 0));

Rezultat

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Izvori