--- title: Array.prototype.splice() slug: Web/JavaScript/Reference/Global_Objects/Array/splice tags: - JavaScript - splice - Масив - заместване - метод - премахване translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice ---
{{JSRef}}

Методът splice() променя съдържанието на масива като изтрива или заменя съществуващи елементи и/или добавя нови.

{{EmbedInteractiveExample("pages/js/array-splice.html")}}

Синтаксис

let arrDeletedItems = array.splice(start[, deleteCount[, item1[, item2[, ...]]]])

Параметри

start
Индексът, от който започва промяната на масива.
Ако числото е по-голямо от дължината на масива, стойността на start ще се промени автоматично и ще приеме стойност равна на дължината на масива. В този случай няма да бъдат изтрити елементи от масива. Методът ще се държи като функция за добавяне на елементи и ще добави толкова елементи колкото са подадени като item[n*].
Ако start е отрицателно число обработката на масива ще започне от края на масива.( Случай че, start e -1 това означава -n е индексът на n-тия последен елемент и следователно е еквивалентен на array.length - n ).
Ако array.length + start е по-малко от 0, ще започне от индекс 0.
deleteCount {{optional_inline}}
Число, което показва колко елемента трябва да бъдат изтрити ( започва се от start ).
If deleteCount is omitted, or if its value is equal to or larger than array.length - start (that is, if it is equal to or greater than the number of elements left in the array, starting at start), then all the elements from start to the end of the array will be deleted.

Note: In IE8, it won't delete all when deleteCount is omitted.

If deleteCount is 0 or negative, no elements are removed. In this case, you should specify at least one new element (see below).
item1, item2, ... {{optional_inline}}
The elements to add to the array, beginning from start. If you do not specify any elements, splice() will only remove elements from the array.

Върната стойност

Методът връща масив, съдържащ изтритите елементи.

Ако само един елемент е премахнат, резултатът ще бъде масив с един елемент.

Ако няма изтрити елементи, резултатът ще бъде празен масив.

Описание

Ако броя на добавените елементи се различава от броя на изтритите, ще има промяна в дължината на масива.

Примери

Премахват се 0 елемента пред индекс 2 и се добавя "drum"

let myFish = ['angel', 'clown', 'mandarin', 'sturgeon']
// Ако изходният ви код е в utf8, можете да ползвате всякакви азбуки
let премахнат = myFish.splice(2, 0, 'drum')

// myFish = ["angel", "clown", "drum", "mandarin", "sturgeon"]
// премахнат = [], не са премахнати елементи

Премахват се 0 елемента пред индекс 2 и се добавят "drum" и "guitar"

let myFish = ['angel', 'clown', 'mandarin', 'sturgeon']
let removed = myFish.splice(2, 0, 'drum', 'guitar')

// myFish = ["angel", "clown", "drum", "guitar", "mandarin", "sturgeon"]
// removed = [], не са премахнати елементи

Премахва се един елемент, започвайки от индекс 3

let myFish = ['angel', 'clown', 'drum', 'mandarin', 'sturgeon']
let removed = myFish.splice(3, 1)

// removed = ["mandarin"]
// myFish = ["angel", "clown", "drum", "sturgeon"]

Remove 1 element at index 2, and insert "trumpet"

let myFish = ['angel', 'clown', 'drum', 'sturgeon']
let removed = myFish.splice(2, 1, 'trumpet')

// myFish = ["angel", "clown", "trumpet", "sturgeon"]
// removed = ["drum"]

Remove 2 elements from index 0, and insert "parrot", "anemone" and "blue"

let myFish = ['angel', 'clown', 'trumpet', 'sturgeon']
let removed = myFish.splice(0, 2, 'parrot', 'anemone', 'blue')

// myFish = ["parrot", "anemone", "blue", "trumpet", "sturgeon"]
// removed = ["angel", "clown"]

Remove 2 elements from index 2

let myFish = ['parrot', 'anemone', 'blue', 'trumpet', 'sturgeon']
let removed = myFish.splice(2, 2)

// myFish = ["parrot", "anemone", "sturgeon"]
// removed = ["blue", "trumpet"]

Remove 1 element from index -2

let myFish = ['angel', 'clown', 'mandarin', 'sturgeon']
let removed = myFish.splice(-2, 1)

// myFish = ["angel", "clown", "sturgeon"]
// removed = ["mandarin"]

Remove all elements after index 2 (incl.)

let myFish = ['angel', 'clown', 'mandarin', 'sturgeon']
let removed = myFish.splice(2)

// myFish = ["angel", "clown"]
// removed = ["mandarin", "sturgeon"]

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

Specification
{{SpecName('ESDraft', '#sec-array.prototype.splice', 'Array.prototype.splice')}}

Съвместимост и подръжка

{{Compat("javascript.builtins.Array.splice")}}

Виж повече