CKTIS / JavaScript
Object.groupBy: agrupar elementos iteráveis num objeto
Object.groupBy percorre um iterável, chama um callback por elemento e devolve um objeto sem protótipo com arrays de grupos.
Versão: ECMAScript 2024 onward; example target: Node.js 24.22.2
Sintaxe
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) obtém um iterador síncrono de items. Para cada elemento chama o callback com o valor e um índice crescente desde 0, aplicando ToPropertyKey ao resultado. Uma chave pode continuar texto ou Symbol; outros resultados tornam-se texto. Cada grupo mantém a ordem de entrada.
O resultado é um objeto novo com protótipo null; cada propriedade própria contém um novo array do grupo. Assim, "__proto__" é uma chave normal segura, mas não existem métodos de Object.prototype; usa, por exemplo, Object.hasOwn. Para preservar chaves objeto arbitrárias em vez de property keys, escolhe Map.groupBy.
O método existe desde ECMAScript 2024. null, undefined, falta de iterador ou callback não invocável causa TypeError. Exceções da iteração, callback ou conversão da chave propagam-se e o iterador é fechado segundo o protocolo. Um índice desde 2**53 - 1 também causa TypeError; um iterável infinito não termina sozinho.
Exemplos
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]);Resultado
true A B,D C true x
O exemplo agrupa por textos, índice e Symbol e mostra o protótipo nulo e a chave __proto__ segura.