Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Map.groupBy: grupowanie iterowalnych danych w Map

Map.groupBy przechodzi po iterable, oblicza klucz dla każdego elementu i zwraca Map, której wartościami są tablice elementów w kolejności wejścia.

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

Składnia

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) pobiera elementy z dowolnego obiektu iterable. Dla każdego wywołuje callbackFn(value, index), gdzie indeks zaczyna się od 0, i dodaje wartość do tablicy przypisanej zwróconemu kluczowi. Wynikiem jest nowa zwykła Map; kolejność kluczy odpowiada ich pierwszemu wystąpieniu, a kolejność elementów w każdej grupie pozostaje kolejnością iteracji.

W przeciwieństwie do Object.groupBy, kluczem może być dowolna wartość, w tym obiekt bez konwersji na łańcuch. Klucze są porównywane według SameValueZero: NaN grupuje się z NaN, a -0 i +0 tworzą jedną grupę reprezentowaną przez +0. Elementy nie są kopiowane ani klonowane — tablice grup przechowują te same wartości i referencje co wejście.

Nieiterowalne items, null/undefined albo niewywoływalny callback powodują TypeError; wyjątek z callbacku jest przekazywany, a otwarty iterator zostaje domknięty. Metoda jest standardowa od ECMAScript 2024. Jest właściwa, gdy klucze mają zachować tożsamość obiektów; dla bezpiecznych kluczy łańcuchowych można rozważyć Object.groupBy.

Przykłady

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

Wynik

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Źródła