Array.prototype.splice() - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

正體中文 (繁體)

Remember language Learn more

Array.prototype.splice()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

splice() 方法可以藉由刪除既有元素並／或加入新元素來改變一個陣列的內容。

嘗試一下

const months = ["Jan", "March", "April", "June"];
months.splice(1, 0, "Feb");
// Inserts at index 1
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "June"]

months.splice(4, 1, "May");
// Replaces 1 element at index 4
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "May"]

語法

array.splice(start[, deleteCount[, item1[, item2[, ...]]]])

參數

start

陣列中要開始改動的元素索引（起始為 0）。若索引大於陣列長度，則實際開始的索引值會被設為陣列長度。若索引為負，則會從陣列中最後一個元素開始往前改動（起始為 -1）且若其絕對值大於陣列的長度，則會被設為 0。

deleteCount 選擇性

一個表示欲刪除的原陣列元素數量的整數。若省略了 deleteCount，或假如其值大於 array.length - start（也就是 deleteCount 大於 start 算起的剩餘元素數量），則所有從 start 開始到陣列中最後一個元素都會被刪除。若 deleteCount 為 0 或是負數，則不會有元素被刪除。因此，你應該給定至少一個欲加入的新元素（見下方說明）。

item1, item2, ... 選擇性

從 start 開始，要加入到陣列的元素。如果你沒有指定任何元素，則 splice() 只會依照 start 和 deleteCount 刪除陣列的元素。

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"];
var removed = myFish.splice(2, 0, "drum");

// myFish 為 ["angel", "clown", "drum", "mandarin", "sturgeon"]
// removed 為 [], 沒有元素被刪除

從索引 3 的位置開始，刪除 1 個元素

js
var myFish = ["angel", "clown", "drum", "mandarin", "sturgeon"];
var removed = myFish.splice(3, 1);

// removed 為 ["mandarin"]
// myFish 為 ["angel", "clown", "drum", "sturgeon"]

從索引 2 的位置開始，刪除 1 個元素並插入「trumpet」

js
var myFish = ["angel", "clown", "drum", "sturgeon"];
var removed = myFish.splice(2, 1, "trumpet");

// myFish 為 ["angel", "clown", "trumpet", "sturgeon"]
// removed 為 ["drum"]

從索引 0 的位置開始，刪除 2 個元素並插入「parrot」、「anemone」和「blue」

js
var myFish = ["angel", "clown", "trumpet", "sturgeon"];
var removed = myFish.splice(0, 2, "parrot", "anemone", "blue");

// myFish 為 ["parrot", "anemone", "blue", "trumpet", "sturgeon"]
// removed 為 ["angel", "clown"]

從索引 2 的位置開始，刪除 2 個元素

js
var myFish = ["parrot", "anemone", "blue", "trumpet", "sturgeon"];
var removed = myFish.splice(myFish.length - 3, 2);

// myFish 為 ["parrot", "anemone", "sturgeon"]
// removed 為 ["blue", "trumpet"]

從索引 -2 的位置開始，刪除 1 個元素

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"];
var removed = myFish.splice(-2, 1);

// myFish 為 ["angel", "clown", "sturgeon"]
// removed 為 ["mandarin"]

從索引 2 的位置開始，刪除所有元素（含索引 2）

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"];
var removed = myFish.splice(2);

// myFish 為 ["angel", "clown"]
// removed 為 ["mandarin", "sturgeon"]

push() / pop() — add/remove elements from the end of the array
unshift() / shift() — add/remove elements from the beginning of the array
concat() — returns a new array comprised of this array joined with other array(s) and/or value(s)

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年7月14日 by MDN contributors.

View this page on GitHub • Report a problem with this content