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

JavaScript / コードを試す

Array.prototype.map()

map() は配列の各要素を関数に通し、その戻り値を集めた新しい配列を返します。配列自体の長さは開始時の長さを引き継ぎます。穴・コールバックの副作用・浅い複製の注意点も確かめます。

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

map() は、配列の各要素を関数に通して、戻り値を集めた新しい配列を返します。 値をまとめて変換したいときに使います。map() 自体は元の配列へ代入しませんが、コールバックが元の配列や共有オブジェクトを変更することはできます。

example.js

const nums = [1, 2, 3];

const doubled = nums.map(n => n * 2);

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

上のコードは書き換えて実行できます。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つの引数が渡されます。

example.js

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

const result = chars.map((value, index, array) => {
  return `${index}:${value}/${array.length}`;
});

console.log(result);
固定例の期待出力 · Node 24.22.3
[ '0:a/3', '1:b/3', '2:c/3' ]
表示用コードUTF-8 · LF

第2引数の index と第3引数の array は、要らなければ書かなくて構いません。

よく使う形

オブジェクトの配列から値を取り出す

オブジェクトから必要なプロパティを取り出せます。

example.js

const users = [{ id: 1, name: 'あ' }, { id: 2, name: 'い' }];

console.log(users.map((user) => user.name));
console.log(users.map(({ name }) => name));
固定例の期待出力 · Node 24.22.3
[ 'あ', 'い' ]
[ 'あ', 'い' ]
表示用コードUTF-8 · LF

下は分割代入で、必要な鍵だけ取り出す書き方です。読みやすいほうを選んでください。

中身を書き換えた新しい配列を作る

example.js

const users = [{ id: 1, name: 'あ' }];

const renamed = users.map((user) => ({ ...user, name: user.name + 'さん' }));

console.log(renamed);
console.log(users);
固定例の期待出力 · Node 24.22.3
[ { id: 1, name: 'あさん' } ]
[ { id: 1, name: 'あ' } ]
表示用コードUTF-8 · LF

{ をそのまま書くと関数の本体と読まれるので、({ ... }) と丸括弧で囲みます。 元の users は変わりません。

番号を振る

example.js

const items = ['あ', 'い', 'う'];

console.log(items.map((item, i) => `${i + 1}. ${item}`));
固定例の期待出力 · Node 24.22.3
[ '1. あ', '2. い', '3. う' ]
表示用コードUTF-8 · LF

絞ってから変換する

example.js

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

console.log(nums.filter((n) => n % 2 === 1).map((n) => n * 10));
固定例の期待出力 · Node 24.22.3
[ 10, 30, 50 ]
表示用コードUTF-8 · LF

この例は filter() で選んだ要素だけを変換します。 順序を変えると、条件を判定する値やコールバックの副作用も変わる場合があります。目的に合う順序を選んでください。 → 配列を変換する・絞り込む

返す値が配列になるなら、flatMap() で平らにしながら変換できます。 → 入れ子の配列を平らにする

よくある間違い

戻り値を書き忘れる

{} で囲んだら return が要ります。書かないと全部 undefined になります。

javascript失敗・注意の例

const nums = [1, 2, 3];

const doubled = nums.map(n => {
  n * 2;
});

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

エラーにはなりません。静かに undefined が並びます。だから気づきにくい。

{} を外すか、return を書けば直ります。

example.js

const nums = [1, 2, 3];
const doubled = nums.map(n => n * 2);
console.log(doubled);
固定例の期待出力 · Node 24.22.3
[ 2, 4, 6 ]
表示用コードUTF-8 · LF

戻り値を使わない

戻り値を使わないなら、map() ではなく forEach() を使います。 map() は新しい配列を作るので、捨てるなら無駄になります。

javascript失敗・注意の例

const nums = [1, 2, 3];

nums.map(n => console.log(n));
固定例の期待出力 · Node 24.22.3
1
2
3
表示用コードUTF-8 · LF

出力そのものは出ます。ただし map() が返した [ undefined, undefined, undefined ] は捨てられています。

map(parseInt) と書く

javascript失敗・注意の例

console.log(['1', '2', '3'].map(parseInt));
固定例の期待出力 · Node 24.22.3
[ 1, NaN, NaN ]
表示用コードUTF-8 · LF

関数名だけ渡すと、引数が3つとも渡ります。 parseInt(値, 添字) として呼ばれ、第2引数が何進法かの指定になってしまいます。

example.js

console.log(parseInt('2', 1));
console.log(parseInt('3', 2));
固定例の期待出力 · Node 24.22.3
NaN
NaN
表示用コードUTF-8 · LF

1進法に 2 は無く、2進法に 3 は無いので NaN です。

Number は引数を1つしか見ないので、そのまま渡せます。

example.js

console.log(['1', '2', '3'].map(Number));
console.log(['1', '2', '3'].map((s) => parseInt(s)));
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3 ]
[ 1, 2, 3 ]
表示用コードUTF-8 · LF

関数名をそのまま渡すときは、その関数が第2・第3引数をどう扱うか確かめてください。 → 文字列を数値に変換する

中のオブジェクトは同じものを指している

javascript失敗・注意の例

const rows = [{ n: 1 }];
const copied = rows.map((row) => row);

copied[0].n = 99;

console.log(rows[0].n);
固定例の期待出力 · Node 24.22.3
99
表示用コードUTF-8 · LF

新しい配列はできますが、中身は同じオブジェクトです(浅いコピー)。 書き換えたいなら、複製してから渡します。

example.js

const rows = [{ n: 1 }];
const copied = rows.map((row) => ({ ...row }));

copied[0].n = 99;

console.log(rows[0].n, copied[0].n);
固定例の期待出力 · Node 24.22.3
1 99
表示用コードUTF-8 · LF

→ オブジェクトを結合する

元の配列を変えたいとき

変換結果で変数を置き換えたいなら、結果を代入し直します。 元の配列への参照を持つ別の変数は、元の配列を指したままです。

example.js

let nums = [1, 2, 3];

nums = nums.map(n => n * 2);

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

const で宣言していると代入し直せません。let を使うか、別の名前にします。

コールバックが元の配列を変更する場合

開始時の長さより後ろへ追加した要素は訪問しません。範囲内の値を変更すると訪問時の値が使われ、未訪問の位置を削除するとその位置は飛ばされます。

example.js

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);
固定例の期待出力 · Node 24.22.3
4 3
2 40 false
表示用コードUTF-8 · LF

元の配列の変更が禁止されるわけではありません。変換と変更を混ぜると追跡しにくいため、用途に合う単純な処理を優先します。

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

要素が入っていない位置(疎な配列の穴)では、コールバック関数は呼ばれません。 穴は穴のまま、結果の配列に残ります。 厳密には、プロトタイプをたどってもその添字が存在しない場合です。継承した添字があれば処理対象になります。

example.js

const sparse = [1, , 3];

const result = sparse.map(n => n * 2);

console.log(result);
console.log(result.length);
固定例の期待出力 · Node 24.22.3
[ 2, <1 empty item>, 6 ]
3
表示用コードUTF-8 · LF

表示のしかたは処理系によって違います。上の出力は、記事冒頭に示したNodeの版で確認しています。

new Array(3) は穴が3つ並んだ配列なので、map() を通しても何も起きません。

example.js

console.log(new Array(3).map((_, i) => i));
console.log(Array.from({ length: 3 }, (_, i) => i));
固定例の期待出力 · Node 24.22.3
[ <3 empty items> ]
[ 0, 1, 2 ]
表示用コードUTF-8 · LF

連番を作るなら Array.from() を使ってください。 Array.from() は長さから作るので、穴を踏みません。

example.js

console.log(Array.from('abc', (c) => c.toUpperCase()));
固定例の期待出力 · Node 24.22.3
[ 'A', 'B', 'C' ]
表示用コードUTF-8 · LF

文字列など配列でないものを配列にしながら変換できるのも Array.from() です。

配列でない値へ適用する

普通のオブジェクトや文字列に .map() メソッドはありませんが、Array.prototype.map 自体は汎用的です。 call() で length と添字を持つ値へ適用できます。

example.js

const values = { 0: 4, 1: 7, length: 2 };

console.log(Array.prototype.map.call(values, n => n * 2));
console.log(Array.isArray(values));
固定例の期待出力 · Node 24.22.3
[ 8, 14 ]
false
表示用コードUTF-8 · LF

通常のオブジェクトの値を変換したいなら、Object.values(values).map(...) が適することもあります。 どのプロパティを対象とするかはデータの意味によって選びます。

null や undefined には適用できません。次の例は文言の違いを避け、例外の種類だけを表示します。

example.js

try {
  Array.prototype.map.call(null, n => n);
} catch (error) {
  console.log(error.name);
}
try {
  [1].map(null);
} catch (error) {
  console.log(error.name);
}
固定例の期待出力 · Node 24.22.3
TypeError
TypeError
表示用コードUTF-8 · LF

まとめ

  • 通常の配列の map() は新しい配列を返す。長さは開始時の長さと同じ
  • コールバックが元の配列を変えることはできる。穴や削除した位置では呼ばれない
  • 減らしたいなら filter()、1つにまとめたいなら reduce()
  • {} で囲んだら return が要る。忘れると undefined が並ぶ
  • 戻り値を使わないなら forEach()
  • map(parseInt) と書かない。引数が3つとも渡る
  • 中のオブジェクトは同じものを指している。複製するなら { ...row }
  • 連番を作るなら Array.from()。new Array(n).map() は動かない

出典

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