Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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__.

Źródła