前言
陣列是 JS 最核心的資料結構。本文系統整理 Array.prototype 主要方法,分類說明語法、回傳值、是否修改原陣列、ES 版本與實戰範例,方便快速查閱。
一、轉換與輸出類
| 方法 | 語法 | 說明 | 修改原陣列 | 回傳值 |
| join | arr.join(sep) | 元素轉字串並用分隔符連接 | 否 | String |
| toString | arr.toString() | 等同 join(',') | 否 | String |
| toLocaleString | arr.toLocaleString() | 各元素呼叫 toLocaleString 後連接 | 否 | String |
二、增刪改 (修改原陣列)
| 方法 | 語法 | 說明 | 回傳值 |
| push | arr.push(...items) | 尾端新增 | 新長度 |
| pop | arr.pop() | 移除尾端 | 被移除元素 |
| unshift | arr.unshift(...items) | 頭部新增 | 新長度 |
| shift | arr.shift() | 移除頭部 | 被移除元素 |
| splice | arr.splice(start, deleteCount, ...items) | 指定位置刪除/插入/替換 | 被刪除元素組成的陣列 |
| reverse | arr.reverse() | 原地反轉 | 陣列本身 |
| sort | arr.sort(compareFn) | 原地排序 | 陣列本身 |
| fill | arr.fill(value, start, end) | 填充指定值 (ES6) | 陣列本身 |
| copyWithin | arr.copyWithin(target, start, end) | 陣列內部複製覆蓋 (ES6) | 陣列本身 |
splice 万能範例
const a = [1,2,3,4,5];
a.splice(2, 0, 'a', 'b'); // 插入: [1,2,'a','b',3,4,5] 回傳 []
a.splice(2, 1); // 刪除1個: [1,2,'b',3,4,5] 回傳 ['a']
a.splice(2, 1, 'x', 'y'); // 替換: [1,2,'x','y',3,4,5] 回傳 ['b']
sort 比較函數
[11,2,22].sort((a,b) => a-b); // [2,11,22] 數值升序
['b','A','a'].sort((a,b) => a.localeCompare(b)); // ['A','a','b'] 區域排序
三、查詢與迭代 (不修改原陣列)
| 方法 | 語法 | 說明 | 回傳值 | ES |
| indexOf | arr.indexOf(val, from) | 首次索引 | Number | ES5 |
| lastIndexOf | arr.lastIndexOf(val, from) | 最後索引 | Number | ES5 |
| includes | arr.includes(val, from) | 是否存在 | Boolean | ES2016 |
| find | arr.find(fn, thisArg) | 第一個通過測試的元素 | 元素/undefined | ES6 |
| findIndex | arr.findIndex(fn, thisArg) | 第一個通過索引 | Number/-1 | ES6 |
| filter | arr.filter(fn, thisArg) | 所有通過測試元素 | 新陣列 | ES6 |
| forEach | arr.forEach(fn, thisArg) | 遍歷執行副作用 | undefined | ES6 |
| map | arr.map(fn, thisArg) | 映射轉換 | 新陣列 | ES6 |
| every | arr.every(fn, thisArg) | 全部通過 | Boolean | ES6 |
| some | arr.some(fn, thisArg) | 至少一個通過 | Boolean | ES6 |
| reduce | arr.reduce(fn, init) | 減縮累積 | 累積結果 | ES6 |
| reduceRight | arr.reduceRight(fn, init) | 從右減縮 | 累積結果 | ES6 |
| flat | arr.flat(depth) | 扁平化 (ES2019) | 新陣列 | ES2019 |
| flatMap | arr.flatMap(fn) | map + flat(1) | 新陣列 | ES2019 |
四、截取與合併 (不修改原陣列)
| 方法 | 語法 | 說明 | 回傳值 |
| slice | arr.slice(start, end) | 淺拷貝片段 [start, end) | 新陣列 |
| concat | arr.concat(...args) | 合併陣列/值 (淺層展開陣列參數) | 新陣列 |
五、ES6+ 新增靜態方法
| 方法 | 說明 |
| Array.from(iterable, mapFn) | 類陣列/可疊代物件 → 陣列 |
| Array.of(...items) | 建立陣列 (修正 Array(3) 行為) |
| Array.isArray(val) | 判斷是否陣列 (跨 realm 安全) |
六、迭代器方法 (ES6)
const arr = ['a','b','c'];
for (const v of arr) console.log(v); // 值
for (const [i, v] of arr.entries()) ... // [索引, 值]
for (const i of arr.keys()) ... // 索引
for (const v of arr.values()) ... // 值
七、常見陷阱總結
- sort() 預設字串排序:數值必須傳比較函數
(a,b)=>a-b。
- splice vs slice:前者改原陣列、回傳刪除項;後者不改、回傳片段。
- 稀疏陣列:
forEach/map/filter 會跳過空位;for...of 會保留 undefined。
- length 可寫:
arr.length = 0 清空陣列;arr.length = 2 截斷。
總結
熟練掌握「修改類 (push/pop/splice/sort)」「查詢類 (find/filter/indexOf)」「轉換類 (map/join/slice/concat)」「疊代類 (forEach/reduce/for...of)」四大類方法,覆蓋 90% 陣列操作場景。優先使用不修改原陣列的函數式方法 (map/filter/reduce),提升程式碼可預測性與可測試性。