Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Map.groupBy: agrupar dados iteráveis num Map

Map.groupBy percorre um iterable, calcula uma chave para cada elemento e devolve um Map cujos valores são arrays que preservam a ordem de entrada.

Versão: ECMAScript 2024 onward; example target: Node.js 24.22.2

Sintaxe

Map.groupBy(items, callbackFn)

Map.groupBy(items, callbackFn) consome elementos de qualquer iterable. Para cada um chama callbackFn(value, index), com índice a começar em 0, e acrescenta o valor ao array da chave devolvida. O resultado é um novo Map normal; a ordem das chaves segue a primeira ocorrência e os valores de cada grupo mantêm a ordem de iteração.

Ao contrário de Object.groupBy, qualquer valor pode ser chave, incluindo um objeto sem conversão para string. As chaves usam SameValueZero: NaN agrupa-se com NaN, enquanto -0 e +0 formam um grupo representado por +0. Os elementos não são copiados nem clonados; os arrays dos grupos guardam os mesmos valores e referências de objeto da entrada.

items não iterable, null/undefined ou callback não invocável lança TypeError; uma exceção do callback propaga-se e o iterador ativo é fechado. O método é padrão desde ECMAScript 2024. É indicado quando as chaves devem manter identidade de objeto; para chaves string seguras, Object.groupBy pode ser adequado.

Exemplos

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

Fontes