JavaScript / コードを試す
Array.prototype.map()
map() は配列の各要素を関数に通し、その戻り値を集めた新しい配列を返します。配列自体の長さは開始時の長さを引き継ぎます。穴・コールバックの副作用・浅い複製の注意点も確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
map() は、配列の各要素を関数に通して、戻り値を集めた新しい配列を返します。
値をまとめて変換したいときに使います。map() 自体は元の配列へ代入しませんが、コールバックが元の配列や共有オブジェクトを変更することはできます。
const nums = [1, 2, 3]; const doubled = nums.map(n => n * 2); console.log(doubled); console.log(nums);
[ 2, 4, 6 ] [ 1, 2, 3 ]
上のコードは書き換えて実行できます。n * 2 を n * n にしてみてください。
構文と引数
構文は array.map(callback, thisArg) です。
| 項目 | 内容 |
|---|---|
callback |
要素を変換する関数。戻り値が結果の配列の要素になる |
thisArg |
コールバックへ渡す任意の this。省略すると undefined が渡り、非strict関数では別途補正される |
| 例外 | コールバックが関数でないと TypeError。コールバック自身の例外も呼び出し元へ伝わる |
アロー関数の this は外側で決まるため、thisArg では変わりません。
何が返るのか
| 中身 | |
|---|---|
| 戻り値 | 通常の配列では新しい配列。長さは開始時の length と同じ |
| 元の配列 | map() 自体は代入しない。コールバックによる変更は可能 |
| 呼ばれる位置 | 開始時の長さの範囲で、訪問時に存在する添字。穴は呼ばれない |
map() は非破壊的メソッドに分類されます。自分で同じ配列を書き換える sort() や reverse() とは異なりますが、渡した関数まで副作用がないとは限りません。
要素を変換するのが map()、要素を絞るのが
filter() です。map() で戻り値を省略しても、要素を除去したことにはなりません。
コールバック関数が受け取るもの
コールバック関数には、3つの引数が渡されます。
const chars = ['a', 'b', 'c']; const result = chars.map((value, index, array) => { return `${index}:${value}/${array.length}`; }); console.log(result);
[ '0:a/3', '1:b/3', '2:c/3' ]
第2引数の index と第3引数の array は、要らなければ書かなくて構いません。
よく使う形
オブジェクトの配列から値を取り出す
オブジェクトから必要なプロパティを取り出せます。
const users = [{ id: 1, name: 'あ' }, { id: 2, name: 'い' }]; console.log(users.map((user) => user.name)); console.log(users.map(({ name }) => name));
[ 'あ', 'い' ] [ 'あ', 'い' ]
下は分割代入で、必要な鍵だけ取り出す書き方です。読みやすいほうを選んでください。
中身を書き換えた新しい配列を作る
const users = [{ id: 1, name: 'あ' }]; const renamed = users.map((user) => ({ ...user, name: user.name + 'さん' })); console.log(renamed); console.log(users);
[ { id: 1, name: 'あさん' } ]
[ { id: 1, name: 'あ' } ]{ をそのまま書くと関数の本体と読まれるので、({ ... }) と丸括弧で囲みます。
元の users は変わりません。
番号を振る
const items = ['あ', 'い', 'う']; console.log(items.map((item, i) => `${i + 1}. ${item}`));
[ '1. あ', '2. い', '3. う' ]
絞ってから変換する
const nums = [1, 2, 3, 4, 5]; console.log(nums.filter((n) => n % 2 === 1).map((n) => n * 10));
[ 10, 30, 50 ]
この例は filter() で選んだ要素だけを変換します。
順序を変えると、条件を判定する値やコールバックの副作用も変わる場合があります。目的に合う順序を選んでください。
→ 配列を変換する・絞り込む
返す値が配列になるなら、flatMap() で平らにしながら変換できます。
→ 入れ子の配列を平らにする
よくある間違い
戻り値を書き忘れる
{} で囲んだら return が要ります。書かないと全部 undefined になります。
const nums = [1, 2, 3];
const doubled = nums.map(n => {
n * 2;
});
console.log(doubled);[ undefined, undefined, undefined ]
エラーにはなりません。静かに undefined が並びます。だから気づきにくい。
{} を外すか、return を書けば直ります。
const nums = [1, 2, 3]; const doubled = nums.map(n => n * 2); console.log(doubled);
[ 2, 4, 6 ]
戻り値を使わない
戻り値を使わないなら、map() ではなく forEach() を使います。
map() は新しい配列を作るので、捨てるなら無駄になります。
const nums = [1, 2, 3];
nums.map(n => console.log(n));1 2 3
出力そのものは出ます。ただし map() が返した [ undefined, undefined, undefined ] は捨てられています。
map(parseInt) と書く
console.log(['1', '2', '3'].map(parseInt));[ 1, NaN, NaN ]
関数名だけ渡すと、引数が3つとも渡ります。
parseInt(値, 添字) として呼ばれ、第2引数が何進法かの指定になってしまいます。
console.log(parseInt('2', 1)); console.log(parseInt('3', 2));
NaN NaN
1進法に 2 は無く、2進法に 3 は無いので NaN です。
Number は引数を1つしか見ないので、そのまま渡せます。
console.log(['1', '2', '3'].map(Number)); console.log(['1', '2', '3'].map((s) => parseInt(s)));
[ 1, 2, 3 ] [ 1, 2, 3 ]
関数名をそのまま渡すときは、その関数が第2・第3引数をどう扱うか確かめてください。 → 文字列を数値に変換する
中のオブジェクトは同じものを指している
const rows = [{ n: 1 }];
const copied = rows.map((row) => row);
copied[0].n = 99;
console.log(rows[0].n);99
新しい配列はできますが、中身は同じオブジェクトです(浅いコピー)。 書き換えたいなら、複製してから渡します。
const rows = [{ n: 1 }]; const copied = rows.map((row) => ({ ...row })); copied[0].n = 99; console.log(rows[0].n, copied[0].n);
1 99
元の配列を変えたいとき
変換結果で変数を置き換えたいなら、結果を代入し直します。 元の配列への参照を持つ別の変数は、元の配列を指したままです。
let nums = [1, 2, 3]; nums = nums.map(n => n * 2); console.log(nums);
[ 2, 4, 6 ]
const で宣言していると代入し直せません。let を使うか、別の名前にします。
コールバックが元の配列を変更する場合
開始時の長さより後ろへ追加した要素は訪問しません。範囲内の値を変更すると訪問時の値が使われ、未訪問の位置を削除するとその位置は飛ばされます。
const nums = [1, 2, 3]; const result = nums.map((n, index) => { if (index === 0) { nums[1] = 20; nums.push(4); delete nums[2]; } return n * 2; }); console.log(nums.length, result.length); console.log(result[0], result[1], 2 in result);
4 3 2 40 false
元の配列の変更が禁止されるわけではありません。変換と変更を混ぜると追跡しにくいため、用途に合う単純な処理を優先します。
空きのある配列では呼ばれない
要素が入っていない位置(疎な配列の穴)では、コールバック関数は呼ばれません。 穴は穴のまま、結果の配列に残ります。 厳密には、プロトタイプをたどってもその添字が存在しない場合です。継承した添字があれば処理対象になります。
const sparse = [1, , 3]; const result = sparse.map(n => n * 2); console.log(result); console.log(result.length);
[ 2, <1 empty item>, 6 ] 3
表示のしかたは処理系によって違います。上の出力は、記事冒頭に示したNodeの版で確認しています。
new Array(3) は穴が3つ並んだ配列なので、map() を通しても何も起きません。
console.log(new Array(3).map((_, i) => i)); console.log(Array.from({ length: 3 }, (_, i) => i));
[ <3 empty items> ] [ 0, 1, 2 ]
連番を作るなら Array.from() を使ってください。
Array.from() は長さから作るので、穴を踏みません。
console.log(Array.from('abc', (c) => c.toUpperCase()));
[ 'A', 'B', 'C' ]
文字列など配列でないものを配列にしながら変換できるのも Array.from() です。
配列でない値へ適用する
普通のオブジェクトや文字列に .map() メソッドはありませんが、Array.prototype.map 自体は汎用的です。
call() で length と添字を持つ値へ適用できます。
const values = { 0: 4, 1: 7, length: 2 }; console.log(Array.prototype.map.call(values, n => n * 2)); console.log(Array.isArray(values));
[ 8, 14 ] false
通常のオブジェクトの値を変換したいなら、Object.values(values).map(...) が適することもあります。
どのプロパティを対象とするかはデータの意味によって選びます。
null や undefined には適用できません。次の例は文言の違いを避け、例外の種類だけを表示します。
try { Array.prototype.map.call(null, n => n); } catch (error) { console.log(error.name); } try { [1].map(null); } catch (error) { console.log(error.name); }
TypeError TypeError
まとめ
- 通常の配列の
map()は新しい配列を返す。長さは開始時の長さと同じ - コールバックが元の配列を変えることはできる。穴や削除した位置では呼ばれない
- 減らしたいなら
filter()、1つにまとめたいならreduce() {}で囲んだらreturnが要る。忘れるとundefinedが並ぶ- 戻り値を使わないなら
forEach() map(parseInt)と書かない。引数が3つとも渡る- 中のオブジェクトは同じものを指している。複製するなら
{ ...row } - 連番を作るなら
Array.from()。new Array(n).map()は動かない