CKTIS / JavaScript
Object.groupBy: grupowanie elementów iterowalnych w obiekt
Object.groupBy przechodzi po iterable, wywołuje callback dla każdego elementu i zwraca obiekt bez prototypu z tablicami grup.
Wersja: ECMAScript 2024 onward; example target: Node.js 24.22.2
Składnia
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) pobiera synchroniczny iterator z items. Dla każdego elementu wywołuje callback z wartością i rosnącym indeksem od 0, a wynik zamienia przez ToPropertyKey. Klucz może więc być tekstem albo symbolem; inne wyniki są konwertowane do tekstu. Elementy i ich kolejność w każdej grupie pozostają takie jak w wejściu.
Wynik jest nowym obiektem z prototypem null, a każda własna właściwość zawiera nową tablicę elementów danej grupy. Dlatego klucz "__proto__" jest bezpieczną zwykłą właściwością, ale wynik nie ma metod Object.prototype; do sprawdzania kluczy używa się np. Object.hasOwn. Jeśli potrzebne są dowolne klucze obiektowe zamiast property keys, właściwą operacją jest Map.groupBy.
Metoda istnieje od ECMAScript 2024. null, undefined, brak iteratora lub niecallable callback powodują TypeError. Wyjątki iteratora, callbacku i konwersji klucza propagują się, a iterator jest wtedy domykany zgodnie z protokołem. Indeks większy lub równy 2**53 - 1 także powoduje TypeError; metoda nie kończy sama nieskończonego iterable.
Przykłady
const urgent = Symbol("urgent");
const tasks = [
{ name: "A", urgent: false },
{ name: "B", urgent: false },
{ name: "C", urgent: true },
{ name: "D", urgent: false }
];
const groups = Object.groupBy(tasks, (task, index) =>
task.urgent ? urgent : (index % 2 === 0 ? "now" : "later")
);
console.log(Object.getPrototypeOf(groups) === null);
console.log(groups.now.map(task => task.name).join(","));
console.log(groups.later.map(task => task.name).join(","));
console.log(groups[urgent].map(task => task.name).join(","));
const safe = Object.groupBy(["x"], () => "__proto__");
console.log(Object.getPrototypeOf(safe) === null, safe.__proto__[0]);Wynik
true A B,D C true x
Przykład grupuje według tekstu, indeksu i Symbolu oraz pokazuje nullowy prototyp i bezpieczny klucz __proto__.