本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

Array.prototype.reduce()

reduce() は配列を1つの値にまとめます。初期値を省いたときの落とし穴、空配列で例外になる条件、元データと累積値の共有、合計・安全な辞書でのグループ化も実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

reduce() は、配列を1つの値にまとめます。 累積値を持ち回りながら、要素を1つずつ畳み込んでいきます。

example.js

const nums = [1, 2, 3, 4];

const total = nums.reduce((sum, n) => sum + n, 0);

console.log(total);
固定例の期待出力 · Node 24.22.3
10
表示用コードUTF-8 · LF

第2引数の 0 が初期値です。省略できますが、省略しないでください(理由は後述)。

上のコードは書き換えて実行できます。sum + n を sum * n、0 を 1 にしてみてください。

引数

中身
第1引数 コールバック関数 (累積値, 要素, 添字, 配列) => 次の累積値
第2引数 初期値(省略可。省略しないほうがよい)
戻り値 最後の累積値。配列とは限らない
元の配列 reduce() 自体は代入しない。コールバックや共有オブジェクト経由の変更は可能

関数でない値を第1引数へ渡すと TypeError になります。コールバックの例外も呼び出し元へ伝わります。

何が起きているか

累積値がどう渡っていくかを見ます。

example.js

const nums = [1, 2, 3];

const total = nums.reduce((sum, n, i) => {
  console.log(`${i}回目: 累積 ${sum} + 要素 ${n} = ${sum + n}`);
  return sum + n;
}, 0);

console.log('結果:', total);
固定例の期待出力 · Node 24.22.3
0回目: 累積 0 + 要素 1 = 1
1回目: 累積 1 + 要素 2 = 3
2回目: 累積 3 + 要素 3 = 6
結果: 6
表示用コードUTF-8 · LF

返した値が、次の回の第1引数になります。 ここが map() との一番の違いです。

return を書き忘れると、次の回の累積値が undefined になります。

javascript失敗・注意の例

const nums = [1, 2, 3];

const total = nums.reduce((sum, n) => {
  sum + n;
}, 0);

console.log(total);
固定例の期待出力 · Node 24.22.3
undefined
表示用コードUTF-8 · LF

初期値を省くと危ない

初期値を省くと、最初に存在する添字の値がそのまま最初の累積値になります。その次に存在する要素からコールバックが呼ばれます。穴のない配列なら2番目の要素からです。

example.js

const nums = [1, 2, 3];

console.log(nums.reduce((a, b) => a + b));
console.log(nums.reduce((a, b) => a + b, 0));
固定例の期待出力 · Node 24.22.3
6
6
表示用コードUTF-8 · LF

数の合計なら同じ結果です。ですが型が違うと壊れます。

javascript失敗・注意の例

const items = [
  { price: 100 },
  { price: 200 },
];

console.log(items.reduce((sum, item) => sum + item.price));
固定例の期待出力 · Node 24.22.3
[object Object]200
表示用コードUTF-8 · LF

最初の累積値がオブジェクトそのものになり、文字列として繋がりました。 初期値 0 を書けば直ります。

example.js

const items = [
  { price: 100 },
  { price: 200 },
];

console.log(items.reduce((sum, item) => sum + item.price, 0));
固定例の期待出力 · Node 24.22.3
300
表示用コードUTF-8 · LF

空配列では例外になる

初期値が無く、要素も無いと、返すものが決まりません。 仕様で TypeError と定められています。

javascript失敗・注意の例

try {
  [].reduce((sum, value) => sum + value);
} catch (error) {
  console.log(error.name);
}
固定例の期待出力 · Node 24.22.3
TypeError
表示用コードUTF-8 · LF

初期値があれば、そのまま返ります。

example.js

console.log([].reduce((a, b) => a + b, 0));
console.log([].reduce((a, b) => a + b, []));
固定例の期待出力 · Node 24.22.3
0
[]
表示用コードUTF-8 · LF

空配列は普通に起こります(filter() の結果など)。 初期値は必ず書いてください。

コールバックと共有データによる変更

reduce() 自体が非破壊的でも、渡した関数が元配列を書き換えることはできます。次は推奨しない副作用の例です。

javascript失敗・注意の例

const nums = [1, 2, 3];
const total = nums.reduce((sum, value, index, array) => {
  array[index] = value * 10;
  return sum + value;
}, 0);
console.log(total);
console.log(nums);
固定例の期待出力 · Node 24.22.3
6
[ 10, 20, 30 ]
表示用コードUTF-8 · LF

初期値のオブジェクトは複製されません。累積値を書き換えると、外にある初期値も変わります。

example.js

const initial = { total: 0 };
const result = [10, 20].reduce((acc, value) => {
  acc.total += value;
  return acc;
}, initial);
console.log(result === initial);
console.log(initial.total);
固定例の期待出力 · Node 24.22.3
true
30
表示用コードUTF-8 · LF

初期値を省き、先頭要素を累積値として更新すると、元の要素まで変わります。

javascript失敗・注意の例

const items = [{ total: 10 }, { total: 20 }];
const result = items.reduce((acc, item) => {
  acc.total += item.total;
  return acc;
});
console.log(result === items[0]);
console.log(items);
固定例の期待出力 · Node 24.22.3
true
[ { total: 30 }, { total: 20 } ]
表示用コードUTF-8 · LF

集計専用の新しい初期値を作れば、この例では元の要素を変更せずに集計できます。

example.js

const items = [{ total: 10 }, { total: 20 }];
const result = items.reduce((acc, item) => {
  acc.total += item.total;
  return acc;
}, { total: 0 });
console.log(result);
console.log(items);
固定例の期待出力 · Node 24.22.3
{ total: 30 }
[ { total: 10 }, { total: 20 } ]
表示用コードUTF-8 · LF

内部のオブジェクトを累積値へそのまま入れれば、その部分は共有されます。初期値を付けるだけで深い複製になるわけではありません。

よく使う形

合計・最大

example.js

const scores = [72, 95, 61, 88];

console.log(scores.reduce((sum, n) => sum + n, 0));
console.log(scores.reduce((max, n) => (n > max ? n : max), -Infinity));
console.log(Math.max(...scores));
固定例の期待出力 · Node 24.22.3
316
95
95
表示用コードUTF-8 · LF

Math.max(...arr)は要素を関数の引数として展開します。渡せる個数の上限は処理系に依存するため、大きい配列ではreduceやループで比較します。

合計まわりの落とし穴(小数・空配列・文字列が混ざる)は 配列の合計を出す にまとめてあります。

数える

example.js

const votes = ['りんご', 'みかん', 'りんご', 'ぶどう', 'りんご'];

const count = votes.reduce((acc, v) => {
  acc[v] = (acc[v] ?? 0) + 1;
  return acc;
}, Object.create(null));

console.log(count);
固定例の期待出力 · Node 24.22.3
{ 'りんご': 3, 'みかん': 1, 'ぶどう': 1 }
表示用コードUTF-8 · LF

初期値はプロトタイプを持たない辞書です。外から来た文字列をキーにするとき、{} に継承される constructor や特別な __proto__ と衝突しないようにします。戻り値は配列ではなくオブジェクトです。

example.js

const votes = ['__proto__', 'constructor', '__proto__'];
const count = votes.reduce((acc, value) => {
  acc[value] = (acc[value] ?? 0) + 1;
  return acc;
}, Object.create(null));
console.log(count.__proto__);
console.log(count.constructor);
console.log(Object.getPrototypeOf(count) === null);
固定例の期待出力 · Node 24.22.3
2
1
true
表示用コードUTF-8 · LF

グループ化

example.js

const users = [
  { name: 'あかり', team: 'A' },
  { name: 'ゆうと', team: 'B' },
  { name: 'はると', team: 'A' },
];

const byTeam = users.reduce((acc, u) => {
  (acc[u.team] ??= []).push(u.name);
  return acc;
}, Object.create(null));

console.log(byTeam);
固定例の期待出力 · Node 24.22.3
{ A: [ 'あかり', 'はると' ], B: [ 'ゆうと' ] }
表示用コードUTF-8 · LF

この例もプロトタイプを持たない辞書を使います。__proto__というチーム名でも専用の配列に分類できます。

example.js

const users = [{ name: 'あかり', team: '__proto__' }];
const byTeam = users.reduce((acc, user) => {
  (acc[user.team] ??= []).push(user.name);
  return acc;
}, Object.create(null));
console.log(byTeam.__proto__);
console.log(Object.getPrototypeOf(byTeam) === null);
固定例の期待出力 · Node 24.22.3
[ 'あかり' ]
true
表示用コードUTF-8 · LF

ES2024のObject.groupBy()でも分類でき、結果はプロトタイプを持たないオブジェクトになります。

example.js

const users = [
  { name: 'あかり', team: 'A' },
  { name: 'ゆうと', team: 'B' },
  { name: 'はると', team: 'A' },
];

console.log(Object.groupBy(users, u => u.team).A.map(u => u.name));
固定例の期待出力 · Node 24.22.3
[ 'あかり', 'はると' ]
表示用コードUTF-8 · LF

使わないほうがよいとき

reduce() は何でも書けてしまいます。書けることと、読みやすいことは別です。

javascript失敗・注意の例

const nums = [1, 2, 3, 4];

const doubled = nums.reduce((acc, n) => {
  acc.push(n * 2);
  return acc;
}, []);

console.log(doubled);
固定例の期待出力 · Node 24.22.3
[ 2, 4, 6, 8 ]
表示用コードUTF-8 · LF

これは map() そのものです。短く、意図もはっきりします。

example.js

const nums = [1, 2, 3, 4];

console.log(nums.map(n => n * 2));
固定例の期待出力 · Node 24.22.3
[ 2, 4, 6, 8 ]
表示用コードUTF-8 · LF
やりたいこと 使うもの
全部を変換する map()
条件で絞る filter()
最初の1件を探す find()
1つの値にまとめる reduce()

reduce() を選ぶのは、出てくる形が元と違うときだけにしてください。 配列が配列のまま出てくるなら、たいてい別のメソッドが合っています。

累積値を毎回作り直さない

短く書きたくてこう書くと、要素の数だけオブジェクトを作り直します。

javascript失敗・注意の例

const votes = ['a', 'b', 'a'];

const count = votes.reduce((acc, v) => ({ ...acc, [v]: (acc[v] ?? 0) + 1 }), {});

console.log(count);
固定例の期待出力 · Node 24.22.3
{ a: 2, b: 1 }
表示用コードUTF-8 · LF

結果は合っています。ですが { ...acc } は毎回まるごと複製しています。 異なるキーが増えると、毎回の複製にかかる総処理量が大きくなります。集計専用に作った累積値なら、上の「数える」のように更新して返せます。外部から受け取った共有オブジェクトを無条件に書き換える、という意味ではありません。

穴のある配列では呼ばれない

配列自身にもプロトタイプ上にも添字がない疎な配列の穴では、コールバック関数は呼ばれません。継承された添字があれば、その値は対象です。

example.js

const sparse = [1, , 3];
let calls = 0;

const total = sparse.reduce((sum, n) => { calls++; return sum + n; }, 0);

console.log(total);
console.log('呼ばれた回数:', calls);
固定例の期待出力 · Node 24.22.3
4
呼ばれた回数: 2
表示用コードUTF-8 · LF

map() と同じ扱いです。find() は穴でも呼ばれるので、そこだけ違います。

初期値がない場合は、先頭側の穴を飛ばして累積値を選びます。長さがあっても添字が1つも存在しない配列は TypeError です。

example.js

const sparse = [, 10, , 20];
const total = sparse.reduce((sum, value, index) => {
  console.log(index);
  return sum + value;
});
console.log(total);
try {
  new Array(3).reduce((sum, value) => sum + value);
} catch (error) {
  console.log(error.name);
}
固定例の期待出力 · Node 24.22.3
3
30
TypeError
表示用コードUTF-8 · LF

開始時の長さより後ろへ追加した要素は処理しません。未訪問の要素の変更は訪問時に読み、削除された添字は飛ばします。集計中に元の配列を変えず、読む処理と更新処理を分けてください。

右から畳み込む

reduceRight() は末尾から回ります。順序が結果に影響するときだけ使います。

example.js

const parts = ['a', 'b', 'c'];

console.log(parts.reduce((acc, s) => acc + s, ''));
console.log(parts.reduceRight((acc, s) => acc + s, ''));
固定例の期待出力 · Node 24.22.3
abc
cba
表示用コードUTF-8 · LF

出典

この教材の原文(Markdown・別タブ)