Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Map.groupBy: združevanje iterabilnih podatkov v Map

Map.groupBy prehodi iterable, izračuna ključ za vsak element in vrne Map s polji vrednosti, ki ohranijo vrstni red vhoda.

Različica: ECMAScript 2024 onward; example target: Node.js 24.22.2

Sintaksa

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) jemlje elemente iz poljubnega iterable. Za vsakega pokliče callbackFn(value, index), kjer se indeks začne z 0, in vrednost doda v polje za vrnjeni ključ. Rezultat je nov navaden Map; vrstni red ključev sledi prvi pojavitvi, vrednosti v vsaki skupini pa ohranijo vrstni red iteracije.

Za razliko od Object.groupBy je lahko ključ poljubna vrednost, tudi objekt brez pretvorbe v niz. Ključi uporabljajo SameValueZero: NaN se združi z NaN, medtem ko -0 in +0 tvorita eno skupino, predstavljeno z +0. Elementi niso kopirani ali klonirani; polja skupin hranijo iste vrednosti in sklice na objekte kot vhod.

Neiterabilni items, null/undefined ali neizvedljiv callback sprožijo TypeError; izjema callbacka se razširi in aktivni iterator se zapre. Metoda je standardna od ECMAScript 2024. Primerna je, kadar morajo ključi ohraniti identiteto objektov; za varne nizovne ključe je lahko primeren Object.groupBy.

Primeri

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

Viri