База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.groupBy: групиране на iterable елементи в обект

Object.groupBy обхожда iterable, извиква callback за всеки елемент и връща обект без прототип с масиви от групи.

Версия: ECMAScript 2024 onward; example target: Node.js 24.22.2

Синтаксис

Object.groupBy(items, callbackFn)

Object.groupBy(items, callbackFn) взема синхронен iterator от items. За всеки елемент извиква callback със стойността и нарастващ от 0 индекс, после прилага ToPropertyKey към резултата. Ключът може да остане string или Symbol; другите резултати стават strings. Във всяка група се пази входният ред.

Резултатът е нов обект с прототип null; всяко собствено свойство съдържа нов масив на групата. Затова "__proto__" е безопасен обикновен ключ, но няма методи от Object.prototype; използвай например Object.hasOwn. За произволни обектни ключове вместо property keys използвай Map.groupBy.

Методът съществува от ECMAScript 2024. null, undefined, липсващ iterator или неcallable callback хвърля TypeError. Изключенията от итерация, callback или преобразуване на ключ се разпространяват и iterator се затваря по протокола. Индекс от 2**53 - 1 също хвърля TypeError; безкраен iterable не приключва сам.

Примери

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

Резултат

true
A
B,D
C
true x

Примерът групира по strings, индекс и Symbol и показва null прототип и безопасен ключ __proto__.

Източници