Loading

ROUTE

ルートゼロの
アクティビティ

JavaScript Object.groupBy()で配列をグループ化する

2

配列の要素をカテゴリや状態ごとにまとめたいとき、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()で戻り値を確認してみてください。

ルートゼロの採用情報を見る

すべてを開示している会社です

ポジティブな面もネガティブな面も、包み隠さず誠実にお答えします。
気になることがあれば、面談の際にすべてオープンにお話します。