JavaScript Object.groupBy()

Definição e uso

Object.groupBy() O método agrupa os elementos do objeto com base no valor de string retornado pela função de callback.

Object.groupBy() O método não altera o objeto original.

Atenção

Os elementos no objeto original e no objeto de retorno são os mesmos.

Qualquer alteração em um objeto refletirá no outro.

Diferenças entre Object.groupBy() e Map.groupBy()

Object.groupBy() e Map.groupBy() A diferença está em:

Object.groupBy() Agrupar elementos em um objeto JavaScript.

Map.groupBy() Agrupar elementos em um objeto Map.

Instância

// Criar um array
const fruits = [
  {name: "apples", quantity: 300},
  {name: "bananas", quantity: 500},
  {name: "oranges", quantity: 200},
  {name: "kiwi", quantity: 150}
];
// Função de callback usada para agrupar elementos
function myCallback({ quantity }) {
  return quantity > 200 ? "ok" : "low";
}
// Agrupar por quantidade
const result = Object.groupBy(fruits, myCallback);

Experimente você mesmo

Sintaxe

Object.groupBy(iterable, callback)

Parâmetro

Parâmetro Descrição
iterable Obrigatório. Array iterável ou Map.
callback

Obrigatório. Função executada para cada elemento.

Esta função deve retornar o nome do grupo do elemento.

Retorno

Tipo Descrição
Iterador Objeto iterável que contém elementos de agrupamento.

Suporte do navegador

Object.groupBy() é uma característica do ES2024.

A partir de março de 2024, todos os navegadores modernos suportam completamente:

Chrome Edge Firefox Safari Opera
Chrome 117 Edge 117 Firefox 119 Safari 17.4 Opera 103
Setembro de 2023 Setembro de 2023 Outubro de 2023 Outubro de 2024 Maio de 2023