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

CKTIS / JavaScript

Object.groupBy: seskupení prvků iterable do objektu

Object.groupBy projde iterable, pro každý prvek zavolá callback a vrátí objekt bez prototypu s poli skupin.

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

Syntaxe

Object.groupBy(items, callbackFn)

Object.groupBy(items, callbackFn) získá synchronní iterátor z items. Pro každý prvek volá callback s hodnotou a indexem rostoucím od 0 a na výsledek použije ToPropertyKey. Klíčem tak může zůstat řetězec nebo Symbol; jiné výsledky se převedou na řetězce. Ve skupinách se zachová vstupní pořadí.

Výsledkem je nový objekt s prototypem null; každá vlastní vlastnost obsahuje nové pole skupiny. Proto je "__proto__" bezpečný běžný klíč, ale chybějí metody Object.prototype; klíče testujte například přes Object.hasOwn. Pro libovolné objektové klíče místo property keys použijte Map.groupBy.

Metoda existuje od ECMAScript 2024. null, undefined, chybějící iterátor nebo nevolatelný callback vyvolá TypeError. Výjimky iterace, callbacku či převodu klíče se šíří a iterátor se dle protokolu zavře. Index od 2**53 - 1 také vyvolá TypeError; nekonečné iterable samo neskončí.

Příklady

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

Výsledek

true
A
B,D
C
true x

Příklad seskupuje podle řetězců, indexu a Symbol a ukazuje nulový prototyp i bezpečný klíč __proto__.

Zdroje