技术文献

Object.groupBy方法

2026-11-18

Object.groupBy() 是 JavaScript 中一个非常实用的方法,可以按照指定条件,把数组中的元素分组。

它不是 React 专有的方法,而是 JavaScript 原生提供的 API,React 项目中也可以直接使用。

1. 基本用法

假设有一个用户数组:

const users = [
  { name: "Tom", age: 18 },
  { name: "Jack", age: 20 },
  { name: "Lucy", age: 18 },
  { name: "John", age: 20 },
  { name: "Mike", age: 25 },
];

现在想按照年龄分组:

const groupedUsers = Object.groupBy(users, (user) => {
  return user.age;
});

console.log(groupedUsers);

结果:

{
  18: [
    { name: "Tom", age: 18 },
    { name: "Lucy", age: 18 }
  ],
  20: [
    { name: "Jack", age: 20 },
    { name: "John", age: 20 }
  ],
  25: [
    { name: "Mike", age: 25 }
  ]
}

可以看到,原来的数组被分成了三个组:

  • 18:年龄为 18 的用户
  • 20:年龄为 20 的用户
  • 25:年龄为 25 的用户

2. 语法解释

Object.groupBy(array, callback)

有两个参数:

参数含义
array需要分组的数组
callback分组规则,返回值决定元素属于哪个组

重点理解:

(user) => user.age

这个回调函数会针对数组中的每个元素执行一次。

例如:

{ name: "Tom", age: 18 }

返回 18,于是 Tom 被放入 18 这个分组。

3. 按照字符串分组

例如,有一个商品数组:

const products = [
  { name: "iPhone", category: "phone" },
  { name: "MacBook", category: "computer" },
  { name: "Samsung", category: "phone" },
  { name: "Dell", category: "computer" },
];

按照商品类别分组:

const result = Object.groupBy(
  products,
  (product) => product.category
);

结果:

{
  phone: [
    { name: "iPhone", category: "phone" },
    { name: "Samsung", category: "phone" }
  ],
  computer: [
    { name: "MacBook", category: "computer" },
    { name: "Dell", category: "computer" }
  ]
}

4. 在 React 中使用

例如,你有一组商品,需要按照类别展示:

const products = [
  { name: "iPhone", category: "phone" },
  { name: "MacBook", category: "computer" },
  { name: "Samsung", category: "phone" },
];

const groupedProducts = Object.groupBy(
  products,
  (product) => product.category
);

return (
  <div>
    {Object.entries(groupedProducts).map(([category, items]) => (
      <section key={category}>
        <h2>{category}</h2>

        {items.map((item) => (
          <p key={item.name}>{item.name}</p>
        ))}
      </section>
    ))}
  </div>
);

这里涉及两个值得理解的方法:

  • Object.groupBy():负责分组。
  • Object.entries():把对象转换成键值对数组,方便使用 map() 遍历。

5. Object.groupBy 和 Map.groupBy 的区别

JavaScript 还提供了一个类似的方法:

Map.groupBy()

两者主要区别在于返回值:

方法返回结果
Object.groupBy()普通对象
Map.groupBy()Map 对象

例如:

const result1 = Object.groupBy(users, user => user.age);

const result2 = Map.groupBy(users, user => user.age);

Object.groupBy() 的分组键会转换为字符串或 Symbol;而 Map.groupBy() 可以保留其他类型的键,例如对象。

注意兼容性: Object.groupBy() 是较新的 JavaScript API(ES2024),需要较新的浏览器或运行环境支持。如果项目需要兼容旧环境,可能需要使用 reduce() 实现分组。

你可以把它理解成:Object.groupBy 就是一个专门用来对数组进行分类整理的方法。