JavaScript / コードを試す
Array.prototype.reduce()
reduce() は配列を1つの値にまとめます。初期値を省いたときの落とし穴、空配列で例外になる条件、元データと累積値の共有、合計・安全な辞書でのグループ化も実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
reduce() は、配列を1つの値にまとめます。
累積値を持ち回りながら、要素を1つずつ畳み込んでいきます。
const nums = [1, 2, 3, 4]; const total = nums.reduce((sum, n) => sum + n, 0); console.log(total);
10
第2引数の 0 が初期値です。省略できますが、省略しないでください(理由は後述)。
上のコードは書き換えて実行できます。sum + n を sum * n、0 を 1 にしてみてください。
引数
| 中身 | |
|---|---|
| 第1引数 | コールバック関数 (累積値, 要素, 添字, 配列) => 次の累積値 |
| 第2引数 | 初期値(省略可。省略しないほうがよい) |
| 戻り値 | 最後の累積値。配列とは限らない |
| 元の配列 | reduce() 自体は代入しない。コールバックや共有オブジェクト経由の変更は可能 |
関数でない値を第1引数へ渡すと TypeError になります。コールバックの例外も呼び出し元へ伝わります。
何が起きているか
累積値がどう渡っていくかを見ます。
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);
0回目: 累積 0 + 要素 1 = 1 1回目: 累積 1 + 要素 2 = 3 2回目: 累積 3 + 要素 3 = 6 結果: 6
返した値が、次の回の第1引数になります。 ここが map() との一番の違いです。
return を書き忘れると、次の回の累積値が undefined になります。
const nums = [1, 2, 3];
const total = nums.reduce((sum, n) => {
sum + n;
}, 0);
console.log(total);undefined
初期値を省くと危ない
初期値を省くと、最初に存在する添字の値がそのまま最初の累積値になります。その次に存在する要素からコールバックが呼ばれます。穴のない配列なら2番目の要素からです。
const nums = [1, 2, 3]; console.log(nums.reduce((a, b) => a + b)); console.log(nums.reduce((a, b) => a + b, 0));
6 6
数の合計なら同じ結果です。ですが型が違うと壊れます。
const items = [
{ price: 100 },
{ price: 200 },
];
console.log(items.reduce((sum, item) => sum + item.price));[object Object]200
最初の累積値がオブジェクトそのものになり、文字列として繋がりました。
初期値 0 を書けば直ります。
const items = [ { price: 100 }, { price: 200 }, ]; console.log(items.reduce((sum, item) => sum + item.price, 0));
300
空配列では例外になる
初期値が無く、要素も無いと、返すものが決まりません。 仕様で TypeError と定められています。
try {
[].reduce((sum, value) => sum + value);
} catch (error) {
console.log(error.name);
}TypeError
初期値があれば、そのまま返ります。
console.log([].reduce((a, b) => a + b, 0)); console.log([].reduce((a, b) => a + b, []));
0 []
空配列は普通に起こります(filter() の結果など)。
初期値は必ず書いてください。
コールバックと共有データによる変更
reduce() 自体が非破壊的でも、渡した関数が元配列を書き換えることはできます。次は推奨しない副作用の例です。
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);6 [ 10, 20, 30 ]
初期値のオブジェクトは複製されません。累積値を書き換えると、外にある初期値も変わります。
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);
true 30
初期値を省き、先頭要素を累積値として更新すると、元の要素まで変わります。
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);true
[ { total: 30 }, { total: 20 } ]集計専用の新しい初期値を作れば、この例では元の要素を変更せずに集計できます。
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);
{ total: 30 }
[ { total: 10 }, { total: 20 } ]内部のオブジェクトを累積値へそのまま入れれば、その部分は共有されます。初期値を付けるだけで深い複製になるわけではありません。
よく使う形
合計・最大
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));
316 95 95
Math.max(...arr)は要素を関数の引数として展開します。渡せる個数の上限は処理系に依存するため、大きい配列ではreduceやループで比較します。
合計まわりの落とし穴(小数・空配列・文字列が混ざる)は 配列の合計を出す にまとめてあります。
数える
const votes = ['りんご', 'みかん', 'りんご', 'ぶどう', 'りんご']; const count = votes.reduce((acc, v) => { acc[v] = (acc[v] ?? 0) + 1; return acc; }, Object.create(null)); console.log(count);
{ 'りんご': 3, 'みかん': 1, 'ぶどう': 1 }初期値はプロトタイプを持たない辞書です。外から来た文字列をキーにするとき、{} に継承される constructor や特別な __proto__ と衝突しないようにします。戻り値は配列ではなくオブジェクトです。
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);
2 1 true
グループ化
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);
{ A: [ 'あかり', 'はると' ], B: [ 'ゆうと' ] }この例もプロトタイプを持たない辞書を使います。__proto__というチーム名でも専用の配列に分類できます。
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);
[ 'あかり' ] true
ES2024のObject.groupBy()でも分類でき、結果はプロトタイプを持たないオブジェクトになります。
const users = [ { name: 'あかり', team: 'A' }, { name: 'ゆうと', team: 'B' }, { name: 'はると', team: 'A' }, ]; console.log(Object.groupBy(users, u => u.team).A.map(u => u.name));
[ 'あかり', 'はると' ]
使わないほうがよいとき
reduce() は何でも書けてしまいます。書けることと、読みやすいことは別です。
const nums = [1, 2, 3, 4];
const doubled = nums.reduce((acc, n) => {
acc.push(n * 2);
return acc;
}, []);
console.log(doubled);[ 2, 4, 6, 8 ]
これは map() そのものです。短く、意図もはっきりします。
const nums = [1, 2, 3, 4]; console.log(nums.map(n => n * 2));
[ 2, 4, 6, 8 ]
reduce() を選ぶのは、出てくる形が元と違うときだけにしてください。
配列が配列のまま出てくるなら、たいてい別のメソッドが合っています。
累積値を毎回作り直さない
短く書きたくてこう書くと、要素の数だけオブジェクトを作り直します。
const votes = ['a', 'b', 'a'];
const count = votes.reduce((acc, v) => ({ ...acc, [v]: (acc[v] ?? 0) + 1 }), {});
console.log(count);{ a: 2, b: 1 }結果は合っています。ですが { ...acc } は毎回まるごと複製しています。
異なるキーが増えると、毎回の複製にかかる総処理量が大きくなります。集計専用に作った累積値なら、上の「数える」のように更新して返せます。外部から受け取った共有オブジェクトを無条件に書き換える、という意味ではありません。
穴のある配列では呼ばれない
配列自身にもプロトタイプ上にも添字がない疎な配列の穴では、コールバック関数は呼ばれません。継承された添字があれば、その値は対象です。
const sparse = [1, , 3]; let calls = 0; const total = sparse.reduce((sum, n) => { calls++; return sum + n; }, 0); console.log(total); console.log('呼ばれた回数:', calls);
4 呼ばれた回数: 2
map() と同じ扱いです。find() は穴でも呼ばれるので、そこだけ違います。
初期値がない場合は、先頭側の穴を飛ばして累積値を選びます。長さがあっても添字が1つも存在しない配列は TypeError です。
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); }
3 30 TypeError
開始時の長さより後ろへ追加した要素は処理しません。未訪問の要素の変更は訪問時に読み、削除された添字は飛ばします。集計中に元の配列を変えず、読む処理と更新処理を分けてください。
右から畳み込む
reduceRight() は末尾から回ります。順序が結果に影響するときだけ使います。
const parts = ['a', 'b', 'c']; console.log(parts.reduce((acc, s) => acc + s, '')); console.log(parts.reduceRight((acc, s) => acc + s, ''));
abc cba