Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes