JavaScript Array toSpliced()

定義和用法

toSpliced() 方法用于添加和/或刪除數組元素。

toSpliced() 方法返回一個新數組。

toSpliced() 方法不會改變原始數組。

toSpliced() 方法是 splice() 方法的復制版本。

另請參閱:

Array splice() 方法

Array slice() 方法

實例

例子 1

// 創建一個數組
const fruits = ["Banana", "Orange", "Apple", "Mango"];
// 在位置 2 添加 "Lemon" 和 "Kiwi"
const fruits2 = fruits.toSpliced(2, 0, "Lemon", "Kiwi");

親自試一試

例子 2

// 創建一個數組
const fruits = ["Banana", "Orange", "Apple", "Mango"];
// 在位置 2 刪除 2 個元素
const fruits2 = fruits.toSpliced(2, 2);

親自試一試

例子 3

// 創建一個數組
const fruits = ["Banana", "Orange", "Apple", "Mango"];
// 在位置 2 刪除 1 個元素,并添加 "Lemon" 和 "Kiwi"
const fruits2 = fruits.toSpliced(2, 1, "Lemon", "Kiwi");

親自試一試

語法

array.toSpliced(index, count, item1, ....., itemX)

參數

參數 描述
index

必需。添加或刪除元素的索引(位置)。

負值從數組末尾開始計算。

count 可選。要刪除的元素數量。
item1,... 可選。要添加的新元素。

返回值

類型 描述
Array 包含更改的新數組。

瀏覽器支持

toSpliced() 是 ES2023 的特性。

自 2023 年 7 月起,所有現代瀏覽器均支持該方法:

Chrome Edge Firefox Safari Opera
Chrome 110 Edge 110 Firefox 115 Safari 16.4 Opera 96
2023 年 2 月 2023 年 2 月 2023 年 7 月 2023 年 3 月 2023 年 5 月