JavaScript中数组分组group与groupToMap提案应用-js教程-PHP中文网

javascript暂无原生group/grouptomap方法，但已作为stage 3提案纳入标准；chrome 117+、edge 117+、node.js 20.6+已默认支持，firefox和safari正在跟进。

javascript中数组分组group与grouptomap提案应用

JavaScript 中目前还没有原生的 group 或 groupToMap 方法，但这两个功能已作为 Stage 3 提案（Array Grouping）被正式纳入 ECMAScript 标准进程。Chrome 117+、Edge 117+、Node.js 20.6+ 已默认启用，Firefox 和 Safari 正在跟进中。实际使用前需确认运行环境支持情况。

group：按条件分组为新数组

Array.prototype.group 接收一个回调函数，该函数对每个元素返回一个分组键（可为任意类型，包括对象、Symbol、undefined），最终返回一个普通对象，键为分组值，值为对应元素组成的数组。

键若为对象或 Symbol，会自动转为字符串（如 {} → "[object Object]"），建议优先使用原始类型作为分组依据
未匹配到任何分组键的元素不会被丢弃，而是归入 undefined 键对应的数组中
返回对象不是 Map，不保证插入顺序（但现代引擎通常按首次出现顺序排列键）

示例：

Javascript Sdk

用于 inference.sh 的 JavaScript/TypeScript SDK，可运行 AI 应用、构建代理、集成 150+ 模型。包名：@inferencesh/sdk（npm install），完整 TypeScript 支持。

下载

const users = [
  { name: 'Alice', age: 28 },
  { name: 'Bob', age: 35 },
  { name: 'Charlie', age: 28 }
];

const grouped = users.group(u => u.age);
// {
//   28: [{ name: 'Alice', age: 28 }, { name: 'Charlie', age: 28 }],
//   35: [{ name: 'Bob', age: 35 }]
// }

groupToMap：更可控的分组结果结构

Array.prototype.groupToMap 行为与 group 类似，但返回的是 Map 实例，天然支持任意类型键、保持插入顺序，并允许后续链式操作（如 forEach、get、has）。

适合需要精确控制键类型（如用日期对象、自定义类实例作键）的场景
避免对象键隐式转换带来的歧义（例如 {id: 1} 和 {id: 1, name: ''} 都转成 "[object Object]"）
Map 的迭代顺序始终与插入顺序一致，适合需顺序敏感的分组展示

示例：

const logs = [
  { time: new Date('2024-01-01'), level: 'warn' },
  { time: new Date('2024-01-02'), level: 'error' },
  { time: new Date('2024-01-01'), level: 'info' }
];

const byDate = logs.groupToMap(log => log.time);
// Map(2) {
//   2024-01-01T00:00:00.000Z => [{ time: ..., level: 'warn' }, { time: ..., level: 'info' }],
//   2024-01-02T00:00:00.000Z => [{ time: ..., level: 'error' }]
// }

兼容性处理与降级方案

在不支持的环境中，可用标准方法模拟实现，注意语义对齐：

group 可用 reduce + 普通对象构建，手动处理 undefined 键逻辑
groupToMap 建议直接用 Map + for...of 或 reduce 构建，确保键类型保留
避免使用 Object.create(null) 替代 Map——它仍无法支持非字符串键

简易 polyfill 片段（仅作示意）：

if (!Array.prototype.group) {
  Array.prototype.group = function (callbackfn, thisArg) {
    const obj = {};
    for (const item of this) {
      const key = callbackfn.call(thisArg, item, this.indexOf(item), this);
      const keyStr = key === undefined ? 'undefined' : String(key);
      if (!obj[keyStr]) obj[keyStr] = [];
      obj[keyStr].push(item);
    }
    return obj;
  };
}