JavaScript метод splice()

JavaScript Array

Определение и применение

JavaScript метод splice() позволяет изменить содержимое массива за счёт удаления существующих элементов, и/или добавления новых элементов в массив.


Обращаю Ваше внимание, что метод splice() изменяет существующий массив, а не возвращает новый. Удаленные элементы возвращаются как новый объект Array.


Поддержка браузерами

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
splice()ДаДаДаДаДаДа

JavaScript синтаксис:

// только с указанием индекса
array.splice( start )

// с указанием индекса и количества удаляемых элементов
array.splice( start, deleteCount )

// с указанием индекса, количества удаляемых элементов и с добавлением элементов
array.splice( start, deleteCount, element1, element2, ..., elementX )

Версия JavaScript

ECMAScript 3 (реализовано в JavaScript 1.2)

Значения параметров

ПараметрОписание
startЦелое число, определяющее индекс массива, с которого будут удалены из массива и/или добавлены в массив элементы. Допускается использование отрицательных значений, в этом случае индекс с которого будет вызван метод будет расчитан по следующей формуле: length (длина массива) + start. Является обязательным значением.
deleteCountЦелое число, определяющее количество удаляемых из массива элементов, начииная с индекса указанного в start. Если deleteCount равен 0, то элементы не удаляются. Если значение deleteCount больше количества оставшихся элементов в массиве, то все оставшиеся элементы массива будут удалены. Необязательное значение, отрицательные значения не допускаются.
element (-s)Элемент, или элементы, которые будут добавлены к массиву. Индекс массива по которому будут вставлены новые элементы соответствует параметру start. Необязательное значение.

Пример использования

var x = [1, 2, 3, "a", "b", "c"]; // инициализируем переменную, содержащую массив

x.splice( 3 ); // значение переменной [1, 2, 3]
x.splice( -3 ); // значение переменной  [1, 2, 3]
x.splice( 2, 2 ); // значение переменной  [1, 2, "b", "c"]
x.splice( -2, 2 ); // значение переменной  [1, 2, 3, "a"]
x.splice( 0, 2, "z", true ); // значение переменной  ["z", true, 3, "a", "b", "c"]
x.splice( 3, 0, "z", "z", "z" ); // значение переменной [1, 2, 3, "z", "z", "z", "a", "b", "c"]
JavaScript Array