JavaScriptで配列のデータを扱うとき、昔のコードでは for 文を使って1つずつループ処理を書くのが一般的でした。しかし現在のモダンJavaScriptでは、目的に合わせて map・filter・find といった配列メソッドを使い分けるのが定番になっています。
私がJavaScriptを学び始めたころは、とりあえず何でも for 文や forEach で回して新しい配列に push する書き方ばかりしていて、他人のコードに出てくる map や filter を見て「どれも似たようなループ処理じゃないの?」と違いがいまいちピンときていませんでした。
もう手が for (let i = 0; i < arr.length; i++) って構文で覚えちゃってたし。
実はこの3つは、「最終的にどんな結果が返ってくるか(戻り値)」で役割がはっきり分かれています。この記事では、それぞれの動きの違いと使い分けの基準、そしてReact開発でよく登場する活用パターンを整理します。
3つのメソッドの結論(何が返ってくるかの違い)
まずは細かいコードを見る前に、3つのメソッドが「何を返してくれるのか」をざっくり頭に入れておきましょう。
- map(変換): すべての要素を加工して、同じ長さの新しい配列を返す
- filter(絞り込み): 条件に合う要素だけを集めた、新しい配列を返す
- find(検索): 条件に合う最初の1件(要素そのもの)だけを返す
どれも「元の配列は書き換えずに、新しい結果を返してくれる」という共通点があります。ここからは、同じ商品データを使ってそれぞれの動きを順番に見ていきます。
// 共通で使うサンプルデータ
const items = [
{ id: 1, name: "コーヒー", price: 300 },
{ id: 2, name: "サンドイッチ", price: 500 },
{ id: 3, name: "ケーキ", price: 600 }
];
1. map:配列の中身を別の形に変換する
map は、配列の要素を1つずつ取り出して加工し、同じ個数の新しい配列を作りたいときに使います。「Aという配列から、Bという配列へ変換する」イメージです。
たとえば、上の items 配列から「商品名だけの配列」を取り出したい場合は次のように書きます。
const names = items.map((item) => {
return item.name;
});
console.log(names);
// ["コーヒー", "サンドイッチ", "ケーキ"]
元の配列が3件なら、返ってくる配列も必ず3件になります。価格をすべて税込(1.1倍)にした新しい配列を作るような場面でもよく使われます。
なお、ただ console.log を出したいだけなど「新しい配列を作る必要がない単純なループ」の場合は、map ではなく forEach を使うのが一般的です。
2. filter:条件に合う要素だけを絞り込む
filter は、コールバック関数の中で true を返した要素だけを集めて、新しい配列を作るメソッドです。文字通り「フィルターをかけて残す」役割をします。
たとえば、「500円以上の商品」だけを絞り込みたい場合は次のように書きます。
const expensiveItems = items.filter((item) => {
return item.price >= 500;
});
console.log(expensiveItems);
// [
// { id: 2, name: "サンドイッチ", price: 500 },
// { id: 3, name: "ケーキ", price: 600 }
// ]
条件に合うものが1つもなかった場合は、エラーにならずに空の配列 [] が返ってきます。また、「特定のID以外の要素を残す」という条件を書けば、元の配列を壊さずに特定の要素を削除する処理としても使えます。
3. find:条件に合う最初の1件だけを探す
find は、条件に合う要素を先頭から探していき、最初に見つかった1件だけをそのまま返すメソッドです。
filter と動きが似ていますが、決定的な違いは「返ってくるのが配列ではなく、要素そのもの(オブジェクトなど)である」という点です。
const targetItem = items.find((item) => {
return item.id === 2;
});
console.log(targetItem);
// { id: 2, name: "サンドイッチ", price: 500 }
IDを指定してユーザー情報や商品詳細を1件だけ取り出したいときは、filter を使うと [ { id: 2, … } ] のように配列に包まれてしまい targetItem[0].name と書く手間が増えます。1件だけ欲しいときは find を使うとそのまま targetItem.name でアクセスできて便利です。
なお、条件に合う要素が1つも見つからなかった場合は undefined が返ってきます。存在しない可能性があるデータを扱うときは、以前の記事で紹介したオプショナルチェーン(?.)と組み合わせて targetItem?.name のように書いておくと安全です。
React開発で map と filter がよく登場する場面
Reactを書いていると、今回紹介した中でも特に map と filter は毎日のように使います。
map で配列データをリスト表示する
Reactでは、配列のデータを画面に一覧表示するときに map を使ってJSX(HTMLのようなタグ)の配列に変換するのが定番の書き方です。
function MenuList({ items }) {
return (
<ul>
{items.map((item) => (
<li key={item.id}>
{item.name}:{item.price}円
</li>
))}
</ul>
);
}
filter でリストから特定の項目を削除する
以前紹介したスプレッド構文(…)の記事でも触れた通り、ReactではStateの配列を直接書き換えてはいけません。そのため、Todoリストなどで「指定したIDのタスクを削除する」ときは filter を使って新しい配列を作り直します。
// targetId と一致しないものだけを残す(=実質的な削除)
const deleteItem = (targetId) => {
setItems(items.filter((item) => item.id !== targetId));
};
このように「元の配列を直接いじらず、新しい配列を返す」という性質が、ReactのState管理と相性抜群なのです。
まとめ
map・filter・find の違いは、「何が返ってくるか」に注目すると迷わなくなります。
- map:要素を加工して、同じ件数の新しい配列を作る
- filter:条件に合う要素だけを集めた、新しい配列を作る
- find:条件に合う最初の1件(要素そのもの)を取り出す
最初は書き方の形が似ていて混同しやすいですが、まずは「一覧を作るときは map、絞り込みや削除は filter、ID検索は find」と覚えておけば、実際の開発でも十分使い分けられるようになります。
なお、この記事の例で使っている (item) => のような書き方はアロー関数という文法です。基本の書き方や省略ルールはアロー関数(=>)とは?で解説しています。


コメント