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

CKTIS / JavaScript

Map.groupBy: agrupar datos iterables en un Map

Map.groupBy recorre un iterable, calcula una clave por elemento y devuelve un Map cuyos valores son arrays que conservan el orden de entrada.

Versión: ECMAScript 2024 onward; example target: Node.js 24.22.2

Sintaxis

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) consume elementos de cualquier iterable. Para cada uno llama a callbackFn(value, index), con índice inicial 0, y añade el valor al array de la clave devuelta. El resultado es un Map ordinario nuevo; el orden de claves sigue su primera aparición y los valores de cada grupo mantienen el orden de iteración.

A diferencia de Object.groupBy, cualquier valor puede ser clave, incluido un objeto sin conversión a cadena. Las claves usan SameValueZero: NaN se agrupa con NaN, mientras que -0 y +0 forman un grupo representado por +0. Los elementos no se copian ni clonan; los arrays de grupos contienen los mismos valores y referencias de objeto que la entrada.

items no iterable, null/undefined o un callback no invocable lanza TypeError; una excepción del callback se propaga y el iterador activo se cierra. El método es estándar desde ECMAScript 2024. Conviene cuando las claves deben conservar identidad de objeto; para claves de cadena seguras puede servir Object.groupBy.

Ejemplos

const engineering = { name: "Engineering" };
const support = { name: "Support" };
const people = [
  { name: "Ada", department: engineering },
  { name: "Lin", department: support },
  { name: "Grace", department: engineering },
];

const byDepartment = Map.groupBy(people, (person) => person.department);
for (const [department, members] of byDepartment) {
  console.log(department.name, members.map(({ name }) => name).join(","));
}
console.log(byDepartment.get(engineering)[0] === people[0]);

const special = Map.groupBy([-0, 0, NaN, NaN], (value) => value);
console.log(special.size, special.get(0).length, special.get(NaN).length);
console.log(Object.is([...special.keys()][0], 0));

Resultado

Engineering Ada,Grace
Support Lin
true
2 2 2
true

Fuentes