← 返回首页
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
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. Array
  6. Array.prototype.splice()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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 г..

Сводка

Метод splice() изменяет содержимое массива, удаляя существующие элементы и/или добавляя новые.

In this article

Синтаксис

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

Параметры

start

Индекс, с которого начинается изменение массива (от нуля), преобразованный в целое число.

  • Отрицательный индекс отсчитывается от конца массива: если -array.length <= start < 0, то используется start + array.length.
  • Если start < -array.length, то используется 0.
  • Если start >= array.length, то ни один элемент не будет удален, но метод добавит столько элементов, сколько указано.
  • Если start опущен (и splice() вызывается без аргументов), то ничего не удаляется. Это отличается от передачи значения undefined, которое преобразуется в 0.
deleteCount Необязательный

Целое число, указывающее количество элементов в массиве, которые нужно удалить, начиная с позиции start.

Если deleteCount не задано или его значение больше или равно количеству элементов после позиции, указанной в start, то будут удалены все элементы от start до конца массива. Если требуется указать параметр itemN, то следует передать Infinity в качестве deleteCount, чтобы удалить все элементы после start, поскольку явное значение undefined преобразуется в 0.

Если deleteCount равно 0 или отрицательное, элементы не удаляются. В этом случае следует указать как минимум один новый элемент (см. ниже).

item1, …, itemN Необязательный

Элементы, которые нужно добавить в массив, начиная со start.

Если не указать никаких элементов, функция splice() только удалит элементы из массива.

Возвращаемое значение

Массив, содержащий удалённые элементы. Если будет удалён только один элемент, вернётся массив из одного элемента. Если никакие элементы не будут удалены, вернётся пустой массив.

Описание

Если количество указанных вставляемых элементов будет отличным от количества удаляемых элементов, массив изменит длину после вызова.

Примеры

Удаляет 0 элементов по индексу 2 и вставляет "drum"

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"]; var removed = myFish.splice(2, 0, "drum"); // myFish равен ["angel", "clown", "drum", "mandarin", "sturgeon"] // removed равен [], ничего не удалено

Удаляет 1 элемент по индексу 3

js
var myFish = ["angel", "clown", "drum", "mandarin", "sturgeon"]; var removed = myFish.splice(3, 1); // removed равен ["mandarin"] // myFish равен ["angel", "clown", "drum", "sturgeon"]

Удаляет 1 элемент по индексу 2 и вставляет "trumpet"

js
var myFish = ["angel", "clown", "drum", "sturgeon"]; var removed = myFish.splice(2, 1, "trumpet"); // myFish равен ["angel", "clown", "trumpet", "sturgeon"] // removed равен ["drum"]

Удаляет 2 элемента начиная с индекса 0 и вставляет "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"]

Удаляет 1 элемент по индексу -2

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"]; var removed = myFish.splice(-2, 1); // myFish равен ["angel", "clown", "sturgeon"] // removed равен s ["mandarin"]

Удаляет все элементы после индекса 2 (включительно)

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"]; var removed = myFish.splice(2); // myFish равен ["angel", "clown"] // removed равен ["mandarin", "sturgeon"]

Спецификации

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

Совместимость с браузерами

Enable JavaScript to view this browser compatibility table.

Обратная совместимость

В JavaScript 1.2 метод splice() возвращал удалённый элемент только если был удалён один элемент (параметр deleteCount равен 1); в противном случае метод возвращал массив с удалёнными элементами. Обратите внимание, что последним браузером, использующим JavaScript 1.2, был Netscape Navigator 4, так что вы можете считать, что splice() всегда возвращает массив.

Смотрите также

  • push() / pop() — добавление / удаление элементов с конца массива
  • unshift() / shift() — добавление / удаление элементов с начала массива
  • concat() — возвращает новый массив, состоящий из данного массива, соединённого с другими массивами и/или значениями

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 18 янв. 2026 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. Array
  3. Конструктор
    1. Array()
  4. Статические методы
    1. Array.from()
    2. fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. Статические свойства
    1. get Array[@@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. 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. toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. Array.prototype.with()
    39. Array.prototype[@@iterator]()
  7. Свойства экземпляра
    1. Array.length
    2. Array.prototype[@@unscopables]
  8. Наследование
  9. Object/Function
  10. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  11. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.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

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.