splice() 是 JavaScript 陣列中功能最強大的方法之一,它能同時「增刪」元素——在指定位置移除舊元素並插入新元素,是 JS 入門的必備知識。
array.splice(index, howMany, [element1][, ..., elementN]);
參數說明:
・index:從該索引開始變更陣列。
・howMany:整數,表示要移除的舊元素數量;若為 0 則不刪除任何元素。
・element1, ..., elementN:要加入陣列的新元素;若不指定,則只刪除元素。
回傳一個由被刪除元素組成的陣列。
<html>
<head>
<title>JavaScript Array splice Method</title>
</head>
<body>
<script type="text/javascript">
var arr = ["orange", "mango", "banana", "sugar", "tea"];
// 在索引 2 處插入 "water",不刪任何元素
var removed = arr.splice(2, 0, "water");
document.write("After adding 1: " + arr);
document.write("<br />removed is: " + removed);
// 從索引 3 處刪除 1 個元素
removed = arr.splice(3, 1);
document.write("<br />After adding 1: " + arr);
document.write("<br />removed is: " + removed);
</script>
</body>
</html>
執行後會輸出:
After adding 1: orange,mango,water,banana,sugar,tea
removed is:
After adding 1: orange,mango,water,sugar,tea
removed is: banana
由範例可見:howMany 為 0 時只做插入、不刪除,removed 為空陣列;howMany 大於 0 時則會移除對應數量並回傳被刪的元素。splice() 因此能同時勝任「插入」「刪除」「取代」三種操作。