← 返回首页
Array.prototype.toSpliced() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
切换侧边栏
  1. 面向开发者的 Web 技术
  2. JavaScript
  3. JavaScript 参考
  4. JavaScript 标准内置对象
  5. Array
  6. Array.prototype.toSpliced()
主题
  • 跟随系统
  • 浅色
  • 深色
中文 (简体)
记住语言 了解更多

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Array.prototype.toSpliced()

基线 广泛可用

自 2023年7月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

Array 实例的 toSpliced() 方法是 splice() 方法的复制版本。它返回一个新数组，并在给定的索引处删除和/或替换了一些元素。

本文内容

语法

js
toSpliced(start) toSpliced(start, deleteCount) toSpliced(start, deleteCount, item1) toSpliced(start, deleteCount, item1, item2, itemN)

参数

start

从 0 开始计算的索引，表示要开始改变数组的位置，它会被转换为整数。

  • 如果 start < 0，则从数组末尾开始计数，使用 start + array.length。
  • 如果 start < -array.length 或者省略了 start，则使用 0。
  • 如果 start >= array.length，不会删除任何元素，但该方法将表现为添加元素的函数，添加提供的所有元素。
deleteCount 可选

一个整数，指示数组中要从 start 删除的元素数量。

如果 deleteCount 被省略了，或者如果它的值大于或等于由 start 指定的位置到数组末尾的元素数量，将会删除从 start 到数组末尾的所有元素。但是，如果你想要传递任何 itemN 参数，则应向 deleteCount 传递 Infinity 值，以删除 start 之后的所有元素，因为显式的 undefined 会转换为 0。

如果 deleteCount 是 0 或者负数，则不会删除元素。在这种情况下，你应该指定至少一个新元素（见下文）。

item1, …, itemN 可选

元素将从 start 开始添加到数组当中。

如果你没有指定任何元素，toSpliced() 只会从数组中删除元素。

返回值

一个新数组，由 start 之前的所有元素、item1、item2、...、itemN，以及 start + deleteCount 之后的所有元素组成。

描述

toSpliced() 方法与 splice() 类似，可以同时完成多个操作：在数组中给定的索引开始移除指定数量的元素，然后在相同的索引处插入给定的元素。但是，它返回一个新数组，而不是修改原始数组。因此，此方法不会返回已删除的元素。

toSpliced() 方法不会产生稀疏数组。如果原始数组是稀疏的，在新数组中空槽将会被替换成 undefined。

toSpliced() 方法是通用的。它只期望 this 值具有 length 属性和整数键属性。

示例

删除、添加和替换元素

你可以通过使用 toSpliced() 来删除、添加和替换数组中的元素，并生成一个新的数组，这比使用 slice() 和 concat() 更高效。

js
const months = ["Jan", "Mar", "Apr", "May"]; // 在索引 1 处添加一个元素 const months2 = months.toSpliced(1, 0, "Feb"); console.log(months2); // ["Jan", "Feb", "Mar", "Apr", "May"] // 从第 2 个索引开始删除两个元素 const months3 = months2.toSpliced(2, 2); console.log(months3); // ["Jan", "Feb", "May"] // 在索引 1 处用两个新元素替换一个元素 const months4 = months3.toSpliced(1, 1, "Feb", "Mar"); console.log(months4); // ["Jan", "Feb", "Mar", "May"] // 原数组不会被修改 console.log(months); // ["Jan", "Mar", "Apr", "May"]

在稀疏数组上使用 toSpliced()

toSpliced() 方法总是会生成一个密集的数组。

js
const arr = [1, , 3, 4, , 6]; console.log(arr.toSpliced(1, 2)); // [1, 4, undefined, 6]

对非数组对象调用 toSpliced()

toSpliced() 方法将会读取 this 的 length 属性。然后，它读取所需的整数键属性并将其写入新数组。

js
const arrayLike = { length: 3, unrelated: "foo", 0: 5, 2: 4, }; console.log(Array.prototype.toSpliced.call(arrayLike, 0, 1, 2, 3)); // [2, 3, undefined, 4]

规范

规范
ECMAScript® 2027 Language Specification
# sec-array.prototype.tospliced

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？
是 否
了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题
  1. JavaScript 标准内置对象
  2. Array
  3. 构造函数
    1. Array() 构造函数
  4. 静态方法
    1. Array.from()
    2. Array.fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. 静态属性
    1. Array[Symbol.species]
  6. 实例方法
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. Array.prototype.findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. Array.prototype.toReversed()
    33. Array.prototype.toSorted()
    34. Array.prototype.toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. Array.prototype.with()
    39. Array.prototype[Symbol.iterator]()
  7. 实例属性
    1. Array：length
    2. Array.prototype[Symbol.unscopables]
  8. 继承
  9. Object/Function
  10. 静态方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. Function.prototype[Symbol.hasInstance]()
  11. 静态属性
    1. Function.displayName
    2. Function：length
    3. Function.name
    4. Function.prototype.prototype
    5. Function.prototype.arguments
    6. Function.prototype.caller
  12. 实例方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. 实例属性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

构建更美好互联网的蓝图。

MDN 参与贡献 开发者

访问 Mozilla 公司的非营利母机构 Mozilla 基金会。
本内容的部分版权归 mozilla.org 贡献者所有，©1998–2026。内容依据知识共享许可协议提供。