紀錄工作經驗、相關知識,解決技術相關問題。

Javascript

JS Array.map() 用法:轉換每個元素

JS Array.map() 用法:轉換每個元素 特色圖片

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' ]

注意事項

  1. 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 ]
  1. 沒有 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 ]
  1. 不用回傳值時不要用 map():MDN 指出,map() 會建立新陣列,呼叫後卻不使用回傳的陣列是反模式(anti-pattern),只想逐筆執行動作時應改用 forEach() 或 for...of。
  2. 稀疏陣列的空位會保留:稀疏陣列(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 ]
  1. 回呼必須是函式:沒有傳回呼會丟出 TypeError(Node.js v22 的訊息是 undefined is not a function)。ECMAScript 規格也規定 callback 不是可呼叫(callable)時要丟出 TypeError。
  2. 處理範圍在開始時就決定: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 或空值。

參考資料與延伸閱讀

發佈留言