JavaScriptのmap・filter・findの違いと使い分けを初心者向けに解説

JavaScriptのmap・filter・findの解説記事のアイキャッチ

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) => のような書き方はアロー関数という文法です。基本の書き方や省略ルールはアロー関数(=>)とは?で解説しています。

コメント

タイトルとURLをコピーしました