Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Map.groupBy: seskupení iterovatelných dat do Map

Map.groupBy projde iterable, vypočítá klíč pro každý prvek a vrátí Map s poli hodnot zachovávajícími pořadí vstupu.

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

Syntaxe

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) odebírá prvky z libovolného iterable. Pro každý zavolá callbackFn(value, index), kde index začíná na 0, a přidá hodnotu do pole pro vrácený klíč. Výsledkem je nová běžná Map; pořadí klíčů odpovídá prvnímu výskytu a hodnoty v každé skupině zachovávají pořadí iterace.

Na rozdíl od Object.groupBy může být klíčem libovolná hodnota včetně objektu bez převodu na řetězec. Klíče používají SameValueZero: NaN se seskupí s NaN, zatímco -0 a +0 vytvoří jednu skupinu reprezentovanou +0. Prvky se nekopírují ani neklonují; pole skupin obsahují stejné hodnoty a odkazy na objekty jako vstup.

Neiterovatelné items, null/undefined nebo nevolatelný callback vyvolají TypeError; výjimka z callbacku se šíří a aktivní iterátor se uzavře. Metoda je standardní od ECMAScript 2024. Hodí se, když klíče musí zachovat identitu objektů; pro bezpečné řetězcové klíče lze použít Object.groupBy.

Pří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ýsledek

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Zdroje