Array.prototype.splice() 是 JavaScript 數組操作中最強大、最核心的方法,唯一能夠原地實現「刪除、插入、替換」三合一的方法。本文詳細解析其語法、參數、返回值、常見用法及性能特性。
array.splice(index, howMany[, element1[, ...[, elementN]]])
| 參數 | 類型 | 說明 |
|---|---|---|
| index | Number | 起始索引。負值表示從末尾倒數 (如 -1 為最後一個)。超過長度則視為 length |
| howMany | Number | 刪除元素個數。0 表示不刪除。超過剩餘長度則刪除到末尾 |
| elementN | Any | 要插入的新元素。省略則僅執行刪除操作 |
返回被刪除元素組成的新數組。若無刪除 (howMany=0) 返回空數組 []。
var arr = ["orange", "mango", "banana", "sugar", "tea"];
var removed = arr.splice(2, 0, "water"); // 索引 2 處插入
console.log(arr); // ["orange", "mango", "water", "banana", "sugar", "tea"]
console.log(removed); // []
var removed = arr.splice(3, 1); // 刪除索引 3 的 1 個元素
console.log(arr); // ["orange", "mango", "water", "sugar", "tea"]
console.log(removed); // ["banana"]
var arr = [1, 2, 3, 4, 5];
arr.splice(1, 2, 'a', 'b'); // 刪除 2,3 插入 a,b
console.log(arr); // [1, 'a', 'b', 4, 5]
var arr = [1, 2, 3, 4, 5];
arr.splice(-2, 1, 'x'); // 倒數第2個位置刪1個插x
console.log(arr); // [1, 2, 3, 'x', 5]
| 方法 | 修改原數組 | 功能 | 典型用途 |
|---|---|---|---|
| splice | ✅ | 刪/增/改 三合一 | 任意位置修改數組 |
| slice | ❌ | 截取子數組 | 複製、分頁、不修改原數組 |
| push/pop | ✅ | 末尾增/刪 | 棧操作 |
| unshift/shift | ✅ | 首部增/刪 | 隊列操作 |
| filter/map | ❌ | 函數式轉換 | 不可變數據流 |
function uniqueInPlace(arr) {
for (let i = 0; i < arr.length; i++) {
for (let j = i + 1; j < arr.length; j++) {
if (arr[i] === arr[j]) {
arr.splice(j, 1);
j--; // 索引回退
}
}
}
return arr;
}
var arr = [1, 2, 3];
var toInsert = [4, 5, 6];
arr.splice(1, 0, ...toInsert); // ES6 展開運算符
console.log(arr); // [1, 4, 5, 6, 2, 3]
function flatten(arr) {
for (let i = 0; i < arr.length; i++) {
if (Array.isArray(arr[i])) {
arr.splice(i, 1, ...arr[i]);
i--; // 重新檢查當前位置
}
}
return arr;
}
Array.prototype.splice.call(arrayLike, ...) 借用<html>
<head><title>JavaScript Array splice Method</title></head>
<body>
<script>
var arr = ["orange", "mango", "banana", "sugar", "tea"];
var removed = arr.splice(2, 0, "water");
document.write("After adding 1: " + arr + "<br>removed is: " + removed);
removed = arr.splice(3, 1);
document.write("<br>After adding 1: " + arr + "<br>removed is: " + removed);
</script>
</body>
</html>
splice() 是數組原地修改的「瑞士軍刀」,掌握其三參數模式 (index, deleteCount, ...items) 能解決 90% 的數組增刪改需求。記住:它修改原數組、返回刪除項、支持負索引、配合展開運算符威力倍增。