Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Map.groupBy: zoskupenie iterovateľných údajov do Map

Map.groupBy prejde iterable, vypočíta kľúč pre každý prvok a vráti Map s poľami hodnôt zachovávajúcimi poradie vstupu.

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

Syntax

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) odoberá prvky z ľubovoľného iterable. Pre každý zavolá callbackFn(value, index), kde index začína na 0, a pridá hodnotu do poľa pre vrátený kľúč. Výsledkom je nová bežná Map; poradie kľúčov zodpovedá prvému výskytu a hodnoty v každej skupine zachovávajú poradie iterácie.

Na rozdiel od Object.groupBy môže byť kľúčom ľubovoľná hodnota vrátane objektu bez prevodu na reťazec. Kľúče používajú SameValueZero: NaN sa zoskupí s NaN, zatiaľ čo -0 a +0 vytvoria jednu skupinu reprezentovanú +0. Prvky sa nekopírujú ani neklonujú; polia skupín obsahujú rovnaké hodnoty a odkazy na objekty ako vstup.

Neiterovateľné items, null/undefined alebo nevolateľný callback vyvolajú TypeError; výnimka z callbacku sa šíri a aktívny iterátor sa uzavrie. Metóda je štandardná od ECMAScript 2024. Hodí sa, keď kľúče musia zachovať identitu objektov; pre bezpečné reťazcové kľúče možno použiť Object.groupBy.

Príklady

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));

Výsledok

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Zdroje