CKTIS / JavaScript
Object.groupBy: agrupar elementos iterables en un objeto
Object.groupBy recorre un iterable, llama un callback por elemento y devuelve un objeto sin prototipo con arrays de grupos.
Versión: ECMAScript 2024 onward; example target: Node.js 24.22.2
Sintaxis
Object.groupBy(items, callbackFn)Object.groupBy(items, callbackFn) obtiene un iterador síncrono de items. Para cada elemento llama al callback con el valor y un índice creciente desde 0, y aplica ToPropertyKey al resultado. Una clave puede seguir siendo texto o Symbol; los demás resultados se convierten en texto. Cada grupo conserva el orden de entrada.
El resultado es un objeto nuevo con prototipo null; cada propiedad propia contiene un array nuevo para su grupo. Por eso "__proto__" es una clave ordinaria segura, pero no hay métodos de Object.prototype; usa, por ejemplo, Object.hasOwn. Si deben mantenerse claves objeto arbitrarias en vez de property keys, usa Map.groupBy.
Existe desde ECMAScript 2024. null, undefined, la falta de iterador o un callback no invocable causa TypeError. Las excepciones de iteración, callback o conversión de clave se propagan y el iterador se cierra según el protocolo. Un índice desde 2**53 - 1 también causa TypeError; un iterable infinito no termina por sí solo.
Ejemplos
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
El ejemplo agrupa por textos, índice y Symbol y muestra el prototipo nulo y la clave __proto__ segura.