Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.groupBy: zoskupenie prvkov iterable do objektu

Object.groupBy prejde iterable, pre každý prvok zavolá callback a vráti objekt bez prototypu s poľami skupín.

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

Syntax

Object.groupBy(items, callbackFn)

Object.groupBy(items, callbackFn) získa synchrónny iterátor z items. Pre každý prvok volá callback s hodnotou a indexom rastúcim od 0 a na výsledok použije ToPropertyKey. Kľúčom tak môže zostať reťazec alebo Symbol; iné výsledky sa prevedú na reťazce. V skupinách sa zachová vstupné poradie.

Výsledkom je nový objekt s prototypom null; každá vlastná vlastnosť obsahuje nové pole skupiny. Preto je "__proto__" bezpečný bežný kľúč, ale chýbajú metódy Object.prototype; kľúče testujte napríklad cez Object.hasOwn. Pre ľubovoľné objektové kľúče namiesto property keys použite Map.groupBy.

Metóda existuje od ECMAScript 2024. null, undefined, chýbajúci iterátor alebo nevolateľný callback vyvolá TypeError. Výnimky iterácie, callbacku či prevodu kľúča sa šíria a iterátor sa podľa protokolu zavrie. Index od 2**53 - 1 tiež vyvolá TypeError; nekonečné iterable samo neskončí.

Prí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ýsledok

true
A
B,D
C
true x

Príklad zoskupuje podľa reťazcov, indexu a Symbol a ukazuje nulový prototyp aj bezpečný kľúč __proto__.

Zdroje