CKTIS / JavaScript
Map.groupBy: групиране на итерируеми данни в Map
Map.groupBy обхожда iterable, изчислява ключ за всеки елемент и връща Map с масиви от стойности, запазващи входния ред.
Версия: ECMAScript 2024 onward; example target: Node.js 24.22.2
Синтаксис
Map.groupBy(items, callbackFn)Map.groupBy(items, callbackFn) взема елементи от всеки iterable. За всеки извиква callbackFn(value, index), с индекс от 0, и добавя стойността към масива за върнатия ключ. Резултатът е нов обикновен Map; редът на ключовете следва първата им поява, а стойностите във всяка група запазват реда на итерация.
За разлика от Object.groupBy, ключ може да е всяка стойност, включително обект без преобразуване към низ. Ключовете използват SameValueZero: NaN се групира с NaN, а -0 и +0 образуват една група, представена с +0. Елементите не се копират или клонират; масивите на групите пазят същите стойности и препратки към обекти като входа.
Неитерируеми items, null/undefined или неизвикваем callback хвърлят TypeError; изключение от callback се разпространява и активният итератор се затваря. Методът е стандартен от ECMAScript 2024. Подходящ е, когато ключовете трябва да пазят идентичност на обекти; за безопасни низови ключове може да се използва Object.groupBy.
Примери
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));Резултат
Engineering Ada,Grace Support Lin true 2 2 2 true