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 月