← 返回首页
Array.prototype.splice() - 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.splice()
主题
  • 跟随系统
  • 浅色
  • 深色
中文 (简体)
记住语言 了解更多

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

View in English Always switch to English

Array.prototype.splice()

基线 广泛可用

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

splice() 方法就地移除或者替换已存在的元素和/或添加新的元素。

要创建一个删除和/或替换部分内容而不改变原数组的新数组，请使用 toSpliced()。要访问数组的一部分而不修改它，参见 slice()。

本文内容

尝试一下

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"]

语法

js
splice(start) splice(start, deleteCount) splice(start, deleteCount, item1) splice(start, deleteCount, item1, item2) splice(start, deleteCount, item1, item2, /* …, */ itemN)

参数

start

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

  • 负索引从数组末尾开始计算——如果 -buffer.length <= start < 0，使用 start + array.length。
  • 如果 start < -array.length，使用 0。
  • 如果 start >= array.length，则不会删除任何元素，但是该方法会表现为添加元素的函数，添加所提供的那些元素。
  • 如果 start 被省略了（即调用 splice() 时不传递参数），则不会删除任何元素。这与传递 undefined 不同，后者会被转换为 0。
deleteCount 可选

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

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

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

item1、…、itemN 可选

从 start 开始要加入到数组中的元素。

如果不指定任何元素，splice() 将只从数组中删除元素。

返回值

一个包含了删除的元素的数组。

如果只移除一个元素，则返回一个元素的数组。

如果没有删除任何元素，则返回一个空数组。

描述

splice() 方法是一个修改方法。它可能会更改 this 的内容。如果指定的要插入的元素数量与要删除的元素数量不同，数组的 length 也将会更改。同时，它会使用 [Symbol.species] 来创建一个新数组实例并返回。

如果删除的部分是稀疏的，则 splice() 返回的数组也是稀疏的，对应的索引为空槽。

splice() 方法是通用的。它只期望 this 值具有 length 属性和整数键属性。尽管字符串也类似于数组，但这种方法不适用于它，因为字符串是不可变的。

示例

在索引 2 处移除 0 个元素，并插入“drum”

js
const myFish = ["angel", "clown", "mandarin", "sturgeon"]; const removed = myFish.splice(2, 0, "drum"); // myFish 是 ["angel", "clown", "drum", "mandarin", "sturgeon"] // removed 是 []，没有移除的元素

在索引 2 处移除 0 个元素，并插入“drum”和“guitar”

js
const myFish = ["angel", "clown", "mandarin", "sturgeon"]; const removed = myFish.splice(2, 0, "drum", "guitar"); // myFish 是 ["angel", "clown", "drum", "guitar", "mandarin", "sturgeon"] // removed 是 []，没有移除的元素

在索引 0 处移除 0 个元素，并插入“angel”

splice(0, 0, ...elements) 像 unshift() 一样在数组的开头插入元素。

js
const myFish = ["clown", "mandarin", "sturgeon"]; const removed = myFish.splice(0, 0, "angel"); // myFish 是 ["angel", "clown", "mandarin", "sturgeon"] // 没有移除的元素

在最后一个索引处移除 0 个元素，并插入“sturgeon”

splice(array.length, 0, ...elements) 像 push() 一样在数组的末尾插入元素。

js
const myFish = ["angel", "clown", "mandarin"]; const removed = myFish.splice(myFish.length, 0, "sturgeon"); // myFish 是 ["angel", "clown", "mandarin", "sturgeon"] // 没有移除的元素

在索引 3 处移除 1 个元素

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

在索引 2 处移除 1 个元素，并插入“trumpet”

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

从索引 0 处移除 2 个元素，并插入“parrot”、“anemone”和“blue”

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

从索引 2 处开始移除 2 个元素

js
const myFish = ["parrot", "anemone", "blue", "trumpet", "sturgeon"]; const removed = myFish.splice(2, 2); // myFish 是 ["parrot", "anemone", "sturgeon"] // removed 是 ["blue", "trumpet"]

在索引 -2 处移除 1 个元素

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

删除从索引 2 开始的所有元素

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

在稀疏数组中使用 splice()

splice() 方法保留了数组的稀疏性。

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

在非数组对象中使用 splice()

splice() 方法读取 this 的 length 属性。然后，它根据需要更新整数键属性和 length 属性。

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

规范

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

浏览器兼容性

启用 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。内容依据知识共享许可协议提供。