Array.prototype.map()(通常簡稱 Array.map())是 JavaScript 用來轉換陣列的內建方法:它對陣列的每個元素各執行一次你給的函式,把回傳值依序放進一個新陣列。
白話一點,就像把一份價目表逐筆套用公式算出新價格:原本的價目表沒變,你只是多了一份算好的新清單。
語法與回傳值
arr.map(callbackFn)
arr.map(callbackFn, thisArg)
| 項目 | 說明 |
|---|---|
callbackFn | 對每個元素執行的函式;它的回傳值會成為新陣列中的一個元素 |
| 回呼的三個參數 | element(目前元素)、index(索引)、array(呼叫 map() 的那個陣列) |
thisArg | 選填,執行 callbackFn 時當作 this 的值 |
| 回傳值 | 新陣列,每個元素都是回呼函式的回傳結果 |
以上依 MDN 的 Array.prototype.map() 頁面整理。新陣列的長度與原陣列相同,map() 不會自己丟掉任何元素。
基本用法:轉換數字
const nums = [1, 4, 9, 16];
const doubled = nums.map((n) => n * 2);
console.log(doubled); // [ 2, 8, 18, 32 ]
console.log(nums); // [ 1, 4, 9, 16 ](原陣列沒有被改動)
map() 本身不會修改原陣列,所以 nums 仍是原本的四個元素。
轉換物件陣列
實務上常把 API 回傳的物件陣列轉成畫面需要的格式。下例先取出單一欄位,再重組成新的物件:
const users = [
{ id: 1, first: 'Ada', last: 'Lin' },
{ id: 2, first: 'Ben', last: 'Wu' },
];
console.log(users.map((u) => `${u.first} ${u.last}`));
// [ 'Ada Lin', 'Ben Wu' ]
console.log(users.map(({ id, first }) => ({ id, name: first })));
// [ { id: 1, name: 'Ada' }, { id: 2, name: 'Ben' } ]
用箭頭函式直接回傳物件時,物件要用小括號包起來(=> ({ ... })),否則大括號會被當成函式本體。
使用 index 與 array 參數
回呼的第二個參數是索引,第三個參數是原陣列,可以用來產生帶編號的結果:
const prices = [100, 250, 399];
console.log(prices.map((p, i, arr) => `${i + 1}/${arr.length}: ${p}`));
// [ '1/3: 100', '2/3: 250', '3/3: 399' ]
注意事項
- map(parseInt) 會得到意外結果:
parseInt的第二個參數是進位基數(radix),而map()會把索引當第二個參數傳進去。MDN 以這個例子說明這種陷阱:
console.log(['1', '2', '3'].map(parseInt));
// [ 1, NaN, NaN ]
解法是包一層只傳需要參數的函式,或改用只接收一個參數的 Number:
console.log(['1', '2', '3'].map((s) => parseInt(s, 10))); // [ 1, 2, 3 ]
console.log(['1', '2', '3'].map(Number)); // [ 1, 2, 3 ]
- 沒有 return 就會得到 undefined:回呼沒有回傳值(或某些分支沒回傳)時,新陣列對應位置會是
undefined。
const n4 = [1, 2, 3, 4];
console.log(n4.map((n, i) => { if (i < 3) { return n; } }));
// [ 1, 2, 3, undefined ]
map() 不能用來刪除元素。要「轉換並篩選」,可以串接 filter():
console.log([1, 2, 3, 4].filter((n) => n % 2 === 0).map((n) => n * 10));
// [ 20, 40 ]
- 不用回傳值時不要用 map():MDN 指出,
map()會建立新陣列,呼叫後卻不使用回傳的陣列是反模式(anti-pattern),只想逐筆執行動作時應改用forEach()或for...of。 - 稀疏陣列的空位會保留:稀疏陣列(sparse array)的空位不會呼叫回呼,結果的同一位置仍是空位:
console.log([1, , 3].map((x, i) => { console.log('Visit', i); return x * 2; }));
// Visit 0
// Visit 2
// [ 2, <1 empty item>, 6 ]
- 回呼必須是函式:沒有傳回呼會丟出
TypeError(Node.js v22 的訊息是undefined is not a function)。ECMAScript 規格也規定callback不是可呼叫(callable)時要丟出TypeError。 - 處理範圍在開始時就決定:ECMAScript 規格說明,
map處理的元素範圍在第一次呼叫回呼之前就設定好了,呼叫開始後才追加進陣列的元素不會被走訪。
對陣列以外的物件使用 map
map() 是泛用(generic)的:只要物件有 length 與整數鍵的屬性,就能用 Array.prototype.map.call() 呼叫。length 之外的屬性會被忽略:
const arrayLike = { length: 3, 0: 2, 1: 3, 2: 4, 3: 5 };
console.log(Array.prototype.map.call(arrayLike, (x) => x ** 2));
// [ 4, 9, 16 ]
常見搭配
map() 回傳的是陣列,所以可以接 filter()、reduce() 等方法。例如先轉換再加總,可以接 JS 陣列加總與平均值:Array.reduce。
如果轉換後想清除 null 或空值,可以看 JS 去除 array 中 null 或空值。
發佈留言