配列の要素をカテゴリや状態ごとにまとめたいとき、JavaScriptのObject.groupBy()を使うと、reduce()で集計用オブジェクトを手作りするより短く書けます。コールバックが返したキーごとに配列が分かれるので、商品カテゴリ、タスク状態、日付グループなどの整理に使えます。まずは基本形を理解し、戻り値が通常のObjectとは少し違う点まで確認しましょう。
Object.groupBy()とは?
Object.groupBy()は、配列などのiterableを順番に処理し、コールバックが返したキーごとに要素をまとめたオブジェクトを返す静的メソッドです。MDNでは2024年3月以降、主要ブラウザーで広く利用できる機能として案内されています。
用語解説:groupBy
複数の要素を「同じ条件のグループ」へ分ける処理です。Object.groupBy()ではコールバックの戻り値がグループ名になります。
最小例:カテゴリごとに配列を分ける
const items = [
{ name: "Apple", category: "fruit" },
{ name: "Hammer", category: "tool" },
{ name: "Banana", category: "fruit" },
];
const grouped = Object.groupBy(items, (item) => item.category);
console.log(grouped.fruit);
// Apple と Banana の2件
コールバックは各要素について呼ばれ、ここではcategoryの値を返しています。同じ文字列を返した要素は同じ配列へまとまります。
reduce()で書く場合との違い
| 観点 | Object.groupBy() | reduce() |
|---|---|---|
| 目的 | グループ化に特化 | 集計や変換全般 |
| 記述量 | 短くなりやすい | 初期値や分岐を自分で書く |
| 自由度 | グループ単位の配列を作る用途向き | 件数集計や複雑な形への変換にも向く |
const grouped = items.reduce((result, item) => {
const key = item.category;
result[key] ??= [];
result[key].push(item);
return result;
}, {});
単純に「同じ条件ごとの配列へ分ける」ならObject.groupBy()が読みやすく、件数だけ数えるなど別の形へ集計したい場合はreduce()が向くことがあります。
条件式の結果でグループを作る
const tasks = [
{ title: "HTML", done: true },
{ title: "CSS", done: false },
{ title: "JavaScript", done: false },
];
const grouped = Object.groupBy(tasks, (task) =>
task.done ? "done" : "todo"
);
console.log(grouped.todo.length); // 2
元のプロパティをそのままキーにする必要はありません。条件式の結果としてdoneやtodoのような文字列を返すこともできます。
戻り値はnull prototypeのオブジェクト
ECMAScript仕様では、Object.groupBy()の戻り値はObject.prototypeを継承しないオブジェクトです。そのため、grouped.hasOwnProperty(…)のような通常のメソッドを前提にしない方が安全です。
const grouped = Object.groupBy(items, (item) => item.category);
console.log(Object.getPrototypeOf(grouped)); // null
console.log(Object.hasOwn(grouped, "fruit")); // true
存在確認にはObject.hasOwn()のような方法を使うと、prototypeの有無に左右されません。
グループ化しても要素はコピーされない
グループ内の配列に入る要素は、元の配列にあるオブジェクトと同じ参照です。深いコピーではありません。
const grouped = Object.groupBy(items, (item) => item.category);
grouped.fruit[0].name = "Green Apple";
console.log(items[0].name); // Green Apple
グループ化後の要素を変更すると元配列側にも影響します。元データを変えたくない処理では、必要に応じて要素をコピーしてから編集してください。
うまく使えないときの確認ポイント
- コールバックが毎回どのキーを返しているか確認する。
- キー名がundefinedや意図しない文字列になっていないか確認する。
- 戻り値がnull prototypeであることを理解し、hasOwnPropertyを直接呼ばない。
- 古い実行環境を対象にする場合はObject.groupBy()対応状況を確認する。
- グループ化だけでなく合計値などを作りたい場合はreduce()や別処理も比較する。
よくある質問とまとめ
Object.groupBy()は配列専用ですか?
配列を含むiterableを受け取れます。実務では配列をグループ化する使い方が分かりやすい出発点です。
数値を返したらどうなりますか?
Object.groupBy()ではグループのキーとしてプロパティキーへ変換されます。読みやすさのため、意味の分かる文字列を返す設計が扱いやすいです。
reduce()はもう不要ですか?
不要にはなりません。Object.groupBy()はグループ化に特化しており、合計・変換・複雑な集計ではreduce()が適する場合があります。
まず3〜5件の小さな配列でcategoryやstatusをキーに分け、console.log()で戻り値を確認してみてください。