JavaScript
PR

JavaScriptの配列メソッド入門|map・filter・reduceとsortの注意点

JavaScriptの配列メソッド入門|map・filter・reduceとsortの注意点
hr
記事内に商品プロモーションを含む場合があります

JavaScript で「全部の値を 2 倍にしたい」「条件に合うものだけ取り出したい」「合計を出したい」と思ったとき、for 文を書く代わりに使えるのが 配列メソッドの map・filter・reduce です。API から受け取った JSON のデータを画面に表示する前の加工など、実際の開発でも毎日のように使います。

この記事では、この 3 つを for 文と比べながら説明し、そのあと find・findIndex・some・every・includes・forEach・sort・toSorted も実例で紹介します。reduce で初期値を省くと空の配列でエラーになること、sort は元の配列を書き換え、数値は比較関数なしだと正しく並ばないことなど、つまずきやすい点は実際の出力で確かめます。載せている出力は、Windows 11 の Microsoft Edge 155 で実際に実行したものです。

この記事のコードの試し方

コードはすべて、ブラウザの開発者ツールのコンソールで試せます。何もインストールする必要はありません。

  1. Edge または Chrome で、どのページでもよいので開いた状態で F12 キーを押します。
  2. 開いた画面の上部にある「Console(コンソール)」タブを選びます。
  3. 記事のコードをコピーして貼り付け、Enter キーを押します。

初めて貼り付けるときは、詐欺を防ぐための警告が出て、確認の文字の入力を求められることがあります。知らない人から教えられたコードはコンソールに貼り付けないでください。同じ名前の変数を使うコードを続けて貼ってエラーになったときは、F5 キーでページを再読み込みしてから貼り直してください。

記事では結果を [2, 4, 6] や { name: "田中" } の形で書いています。コンソールでは要素の数が前に付くなど、見た目が少し違うことがあります。JavaScript の基本や開発者ツールの開き方は「JavaScriptとは?」でも紹介しています。

配列メソッドとは?for 文と比べてみる

配列メソッドは、配列([100, 250, 480] のように値を並べたもの)に最初から用意されている関数です。たとえば「税抜きの値段のリストから、税込み(10%)の値段のリストを作る」処理を for 文で書くと、次のようになります。

const prices = [100, 250, 480];
const withTax = [];
for (let i = 0; i < prices.length; i++) {
  withTax.push(Math.floor(prices[i] * 1.1));
}
console.log(withTax);
[110, 275, 528]

空の配列を用意する、番号 i を 0 から数える、push で 1 つずつ足す、という「やりたいこと以外の手順」がたくさんあります。同じ処理を map で書くと 1 行になります。

const prices = [100, 250, 480];
const withTax = prices.map((price) => Math.floor(price * 1.1));
console.log(withTax);
console.log(prices);
[110, 275, 528]
[100, 250, 480]

(price) => Math.floor(price * 1.1) の部分はアロー関数という短い関数の書き方で、「price を受け取って、price × 1.1 の小数点以下を切り捨てた値を返す」という意味です。map はこの関数を要素ごとに呼び、返ってきた値を並べた新しい配列を作ります。2 行目の出力のとおり、元の配列 prices は変わりません(Math.floor を付けないと 100 * 1.1 が 110.00000000000001 になる理由は「浮動小数点数の誤差とは?」で解説しています)。この記事で扱うメソッドをまとめると、次のとおりです。

メソッドやること返す値元の配列
map全部の要素を変換する新しい配列(長さは同じ)変わらない
filter条件に合う要素だけ残す新しい配列(短くなることがある)変わらない
reduce全部の要素を 1 つの値にまとめるまとめた値(数・オブジェクトなど)変わらない
find / findIndex条件に合う最初の要素を探す要素 / 位置の番号変わらない
some / every1 つでも / 全部が条件に合うか調べるtrue か false変わらない
includesその値が入っているか調べるtrue か false変わらない
forEach要素ごとに処理をするだけundefined(何も返さない)変わらない
sort並べ替える並べ替えた元の配列変わる
toSorted並べ替えたコピーを作る新しい配列変わらない

map:全部の要素を変換して新しい配列を作る

map に渡す関数は、1 つ目の引数で要素の値を、2 つ目の引数で位置の番号(インデックス、0 から始まる)を受け取れます。番号付きのラベルを作る例です。

const names = ["田中", "鈴木", "佐藤"];
const labels = names.map((name, i) => `${i + 1}. ${name}`);
console.log(labels);
["1. 田中", "2. 鈴木", "3. 佐藤"]

`...`(バッククォート)で囲んだ文字列はテンプレートリテラルといい、${ } の中に書いた式の値が埋め込まれます。map の結果は必ず元の配列と同じ長さになります。要素を減らしたいときは、次の filter を使います。

filter:条件に合う要素だけを残す

filter に渡す関数が true を返した要素だけが、新しい配列に残ります。60 点以上の点数だけを取り出す例です。

const scores = [72, 95, 58, 88, 40];
console.log(scores.filter((score) => score >= 60));
console.log(scores.filter((score) => score >= 100));
console.log(scores);
[72, 95, 88]
[]
[72, 95, 58, 88, 40]

条件に合う要素が 1 つもないときは、エラーではなく空の配列 [] が返ります。こちらも元の配列はそのままです。

reduce:全部の要素を 1 つの値にまとめる

reduce は、配列を左から順に処理しながら、結果を 1 つの値に「たたみ込んで」いくメソッドです。いちばん分かりやすいのが合計です。

const nums = [1, 2, 3, 4];
const total = nums.reduce((acc, n) => acc + n, 0);
console.log(total);
10

reduce には 2 つのものを渡します。1 つ目は「これまでの結果(acc、accumulator=ためておくもの の略)」と「今の要素(n)」を受け取って次の結果を返す関数、2 つ目は初期値(ここでは 0)です。中では次のように計算が進みます。

回目acc(これまでの結果)n(今の要素)返す値 acc + n
10(初期値)11
2123
3336
46410

最後に返した 10 が、reduce の結果になります。

初期値を省くと、空の配列で TypeError になる

初期値は省略できます。省くと、配列の最初の要素が初期値の代わりになり、2 つ目の要素から処理が始まります。合計なら結果は同じですが、配列が空のときに違いが出ます。

const empty = [];
console.log(empty.reduce((acc, n) => acc + n, 0));
console.log(empty.reduce((acc, n) => acc + n));
0
Uncaught TypeError: Reduce of empty array with no initial value

初期値があれば空の配列でも 0 が返りますが、初期値がないと「最初の要素」がないため TypeError(型のエラー)で止まります。ECMAScript の仕様にも「配列に要素がなく、初期値も渡されていなければ TypeError」と書かれています。検索結果が 0 件のときなど、空の配列は実際の開発でよく起きるので、reduce には初期値を必ず書くと覚えておくと安全です。

初期値を省くと、空でなくてもおかしな結果になる場合があります。オブジェクトの配列で値段を合計しようとした例です。

const items = [{ name: "ペン", price: 120 }, { name: "ノート", price: 200 }];
console.log(items.reduce((acc, item) => acc + item.price));
console.log(items.reduce((acc, item) => acc + item.price, 0));
[object Object]200
320

初期値がないと、最初の acc は数ではなく 1 つ目のオブジェクト { name: "ペン", price: 120 } になります。オブジェクトと数を + でつなぐと文字列の連結になるため、「[object Object]200」という意味のない文字列ができてしまいます。

reduce でグループ分けする

初期値に空のオブジェクト {} を渡すと、合計以外のまとめ方もできます。種類ごとに名前を分ける例です。

const foods = [
  { name: "りんご", type: "果物" },
  { name: "にんじん", type: "野菜" },
  { name: "バナナ", type: "果物" },
];
const groups = foods.reduce((acc, food) => {
  if (!acc[food.type]) {
    acc[food.type] = [];
  }
  acc[food.type].push(food.name);
  return acc;
}, {});
console.log(groups);
{ 果物: ["りんご", "バナナ"], 野菜: ["にんじん"] }

「その種類の配列がまだなければ作り、名前を足して、acc を返す」を繰り返しています。関数を { } で囲んで複数行で書くときは、最後に return acc; を忘れないことが大切です。忘れると関数が undefined を返すため、次の回の acc が undefined になり、この例では「TypeError: Cannot read properties of undefined (reading ‘野菜’)」というエラーで止まります。

なお、グループ分けには ES2024 で追加された Object.groupBy() も使えます。Object.groupBy(foods, (food) => food.type) で、種類ごとにオブジェクトそのものを配列にまとめられます(Edge 155 で確認)。古いブラウザにも対応するなら reduce の書き方が確実です。

map → filter → reduce を順につなぐ(メソッドチェーン)

map と filter は新しい配列を返すので、その結果にそのまま次のメソッドを続けて書けます。これをメソッドチェーンといいます。「2 倍にして、4 より大きいものだけ残して、合計する」処理です。

const nums = [1, 2, 3, 4];
const result = nums
  .map((n) => n * 2)
  .filter((n) => n > 4)
  .reduce((acc, n) => acc + n, 0);
console.log(result);
14
配列 1, 2, 3, 4 が 3 つの段階を通って変わる流れ。map で n を 2 倍にすると 2, 4, 6, 8 になり、filter で 4 より大きいものだけ残すと 6, 8 になり、reduce で初期値 0 から足し合わせると 14 という 1 つの数になる。元の配列 1, 2, 3, 4 は変わらない。
図 1:map・filter・reduce で配列が変わっていく流れ

図 1 のように、map で [2, 4, 6, 8]、filter で [6, 8]、reduce で 14 と、1 段ずつ形が変わっていきます。メソッドの前で改行して .map のように行頭に点を置くと、処理の順番が上から読めて分かりやすくなります。

探す・調べる:find・findIndex・some・every・includes

配列から「1 つだけ探す」「あるかどうか調べる」ためのメソッドです。filter で全部取り出してから 1 つ目を使うより、目的がはっきりした名前のメソッドを使うほうが読みやすくなります。

const users = [
  { id: 1, name: "田中", age: 28 },
  { id: 2, name: "鈴木", age: 35 },
  { id: 3, name: "佐藤", age: 42 },
];
console.log(users.find((u) => u.age > 30));
console.log(users.find((u) => u.age > 50));
console.log(users.findIndex((u) => u.name === "佐藤"));
console.log(users.findIndex((u) => u.name === "高橋"));
{ id: 2, name: "鈴木", age: 35 }
undefined
2
-1

find は条件に合う最初の 1 つを返します。鈴木さんも佐藤さんも 30 歳より上ですが、返るのは先にある鈴木さんだけです。findIndex はその位置の番号を返します。見つからないとき、find は undefined、findIndex は -1 です。find の結果をそのまま .name のように使うと、見つからなかったときに「Cannot read properties of undefined」というエラーになります。見つからない場合があるときは、if (user) で確かめてから使いましょう。

const ages = [28, 35, 42];
console.log(ages.some((age) => age >= 40));
console.log(ages.every((age) => age >= 30));
console.log(ages.includes(35));
console.log(ages.includes("35"));
true
false
true
false

some は1 つでも条件に合えば true(40 歳以上の人がいるか)、every は全部が合えば true です(28 歳の人がいるので false)。includes には関数ではなく値そのものを渡し、数の 35 と文字列の "35" は別の値として扱われます。

空の配列 [] では、some は false、every は true になります。「条件に合わない要素が 1 つもない」ので every は true、という考え方です。「全員が合格なら OK」のような判定で、対象が 0 人でも OK になってしまうので注意しましょう。

forEach は値を返さない

forEach は、要素ごとに関数を呼ぶだけのメソッドです。map と形が似ていますが、結果の配列を作らず、いつも undefined を返します。

const result = [1, 2, 3].forEach((n) => console.log(n * 10));
console.log(result);
10
20
30
undefined

使い分けは、新しい配列がほしいなら map、表示や保存など「するだけ」なら forEach です。また forEach には for 文の break のような「途中でやめる」方法がありません。見つかった時点でやめたいときは、find や some(条件に合った時点で処理が止まる)か、for...of 文を使います。

実例:JSON から受け取ったオブジェクトの配列を加工する

Web API から返ってくるデータは、多くの場合「オブジェクトの配列」の JSON です。JSON.parse() で JavaScript の配列にすれば、ここまでのメソッドがそのまま使えます。在庫のある商品の名前と在庫の合計金額を出し、最後に画面に必要な項目だけのオブジェクトに変換して、JSON.stringify() で JSON の文字列に戻す例です。

const json = '[{"id":1,"name":"ノート","price":200,"stock":12},{"id":2,"name":"ペン","price":120,"stock":0},{"id":3,"name":"ファイル","price":350,"stock":5}]';
const products = JSON.parse(json);
const inStock = products.filter((p) => p.stock > 0);
console.log(inStock.map((p) => p.name));
console.log(inStock.reduce((sum, p) => sum + p.price * p.stock, 0));
const summary = products.map((p) => ({ name: p.name, soldOut: p.stock === 0 }));
console.log(JSON.stringify(summary, null, 2));
["ノート", "ファイル"]
4150
[
  {
    "name": "ノート",
    "soldOut": false
  },
  {
    "name": "ペン",
    "soldOut": true
  },
  {
    "name": "ファイル",
    "soldOut": false
  }
]

在庫 0 のペンが filter で外れ、200 × 12 + 350 × 5 = 4150 になりました。JSON.stringify の 3 つ目の引数 2 は、スペース 2 つで字下げして見やすくする指定です。map の中で ({ ... }) と丸かっこで囲んでいる理由は、後の「よくある間違い」で説明します。

実際の API の JSON は 1 行に詰まっていて読みにくいことが多いので、どんな項目があるかを先に確かめると、map や filter の条件が書きやすくなります。当サイトの「JSON整形ツール」に貼り付けると、ブラウザの中だけで見やすく整形でき、構文の間違いがあれば場所を日本語で教えてくれます。

sort は元の配列を書き換える

並べ替えの sort は、ここまでのメソッドと違って元の配列そのものを並べ替えます(返す値も、新しい配列ではなく元の配列です)。さらに、何も渡さないと要素を文字列に変えてから比べるため、数が大きさの順に並びません。

const nums = [10, 9, 1];
console.log(nums.sort());
console.log(nums);
[1, 10, 9]
[1, 10, 9]

10 と 9 を文字列の “10” と “9” として 1 文字目から比べると、”1″ のほうが “9” より前なので “10” が先になります。そして 2 行目のとおり、元の nums も並べ替わっています。

数を並べ替えるには比較関数を渡す

sort に「2 つの値 a と b を受け取って、a を前にしたいなら負の数、後ろにしたいなら正の数、同じなら 0 を返す関数」(比較関数)を渡すと、その結果に従って並べます。数の小さい順なら a - b、大きい順なら b - a と書くだけです。

const nums = [10, 9, 1];
console.log(nums.sort((a, b) => a - b));
console.log(nums.sort((a, b) => b - a));
[1, 9, 10]
[10, 9, 1]

オブジェクトの配列は、比べたい項目を引き算します(例:年齢の高い順なら users.sort((a, b) => b.age - a.age))。なお、const sorted = nums.sort((a, b) => a - b); のように結果を別の変数に入れても、sorted と nums は同じ配列を指しています(sorted === nums は true になります)。元の順番を残したいときは、次の toSorted を使います。

元の配列を変えない toSorted(ES2023)

ES2023 で、元の配列を変えずに並べ替えたコピーを返す toSorted が追加されました。使い方は sort と同じです。

const nums = [10, 9, 1];
const sorted = nums.toSorted((a, b) => a - b);
console.log(sorted);
console.log(nums);
[1, 9, 10]
[10, 9, 1]

同じ ES2023 で、reverse(逆順)の代わりの toReversed、splice(削除・挿入)の代わりの toSpliced、1 つの要素を置き換えたコピーを作る with も入りました。Edge 155 では、どれも動くことを確認しています。MDN では 2023 年 7 月以降の主要なブラウザで使えるとされていますが、古いブラウザでも動かす必要があるときは、[...nums].sort((a, b) => a - b) のように先にコピーしてから sort する書き方を使います。

元の配列を書き換えるメソッドは、sort のほかに push・pop・shift・unshift・splice・reverse・fill・copyWithin があります。React などで「配列を書き換えたのに画面が変わらない」という問題は、これらのメソッドで元の配列を直接変えたことが原因のことがあります。

よくある間違い

map で { } を付けて return を忘れ、undefined だらけになる

const nums = [1, 2, 3];
const doubled = nums.map((n) => {
  n * 2;
});
console.log(doubled);
[undefined, undefined, undefined]

アロー関数は、=> のあとに式だけを書くとその値が自動で返されますが、{ } で囲むと「処理のまとまり」になり、return を書かない限り何も返しません(undefined を返します)。直し方は次のどちらかです。

  • { } を外す:nums.map((n) => n * 2)
  • return を書く:nums.map((n) => { return n * 2; })

アロー関数でオブジェクトを返すときは ( ) で囲む

const names = ["田中", "鈴木"];
console.log(names.map((name) => { name: name }));
console.log(names.map((name) => ({ name: name })));
[undefined, undefined]
[{ name: "田中" }, { name: "鈴木" }]

1 行目は、オブジェクトを返したつもりでも、{ } が「処理のまとまり」と読まれてしまいます(中の name: は「ラベル」という別の文法と解釈されます)。エラーにならず undefined が並ぶだけなので、気づきにくい間違いです。オブジェクトを返すときは ({ ... }) のように丸かっこで囲みます。

map(parseInt) で NaN が混ざる

console.log(["1", "2", "3"].map(parseInt));
console.log(["1", "2", "3"].map(Number));
[1, NaN, NaN]
[1, 2, 3]

map は関数に「値・位置の番号・配列」の 3 つを渡します。parseInt は 2 つ目の引数を「何進数か」として使うため、parseInt("2", 1)(1 進数)や parseInt("3", 2)(2 進数に 3 はない)が呼ばれて NaN になります。文字列を数にするなら map(Number) か、map((s) => parseInt(s, 10)) と引数をはっきり書きます。

よくある質問

for 文と配列メソッドは、どちらを使えばいいですか?

「変換する」「絞り込む」「まとめる」がはっきりしているなら、map・filter・reduce のほうが目的が名前で伝わり、読みやすくなります。途中で処理をやめたい(break)、await で 1 つずつ順番に待ちたい、複数の配列を複雑に行き来する、といった場合は for...of 文のほうが素直に書けます。

map で作った新しい配列の中のオブジェクトは、元とは別物ですか?

いいえ、配列だけが新しくなり、中のオブジェクトは同じものを指します(MDN では「浅いコピー」と説明されています)。たとえば filter で取り出したオブジェクトの price を書き換えると、元の配列から見ても書き換わっています。中身も変えずに残したいときは、map の中で ({ ...p, price: 0 }) のように新しいオブジェクトを作って返します。

Python のリスト処理とはどう対応しますか?

Python でいうと、map は内包表記の [n * 2 for n in nums]、filter は [n for n in nums if n > 4]、合計の reduce は sum(nums)、toSorted は sorted(nums) に当たります。Python の sort() は数をそのまま大きさの順に並べるので、JavaScript の「文字列として比べる」動きは Python に慣れた人ほど引っかかりやすい点です。Python 側の書き方は「Pythonのリスト・辞書・内包表記の基本」で解説しています。

まとめ

map は変換、filter は絞り込み、reduce はまとめる、どれも元の配列は変えません。reduce には初期値を必ず書き、数の sort には (a, b) => a - b を渡し、元を変えたくなければ toSorted を使いましょう。アロー関数で { } を使うなら return を、オブジェクトを返すなら ({ }) を忘れずに。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました