Метод splice()

Array.splice()

Вставляет, удаляет или замещает элементы массива.

Синтаксис

array.splice(start, deleteCount, element1, element2, ..., elementN)

Параметры

start

Индекс элемента массива, с которого будут удалены из массива и/или добавлены в массив элементы. Допускается использование отрицательных значений, в этом случае индекс с которого будет вызван метод будет расчитан по следующей формуле: length (длина массива) + start.

deleteCount

Необязательное значение. Целое число, определяющее количество удаляемых из массива элементов, начииная с индекса указанного в start. Если deleteCount равен 0, то элементы не удаляются. Если значение deleteCount больше количества оставшихся элементов в массиве, то будут удалены все элементы до конца массива. Отрицательные значения не допускаются.

elementN

Необязательное значение. Добавляемые к массиву элементы. Если вы не укажете никакого элемента, splice() просто удалит элементы из массива.

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

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

Описание

Метод splice() удаляет указанное количество элементов массива, начиная с элемента, позиция которого определяется аргументом start, включая его, и заменяет значениями, перечисленными в списке аргументов (element1, ..., elementN). Элементы массива, расположенные после вставляемых или удаляемых элементов, сдвигаются и образуют непрерывную последовательность с остальной частью массива.

Примеры

Метод splice() удаляет 0 элементов по индексу 2 и вставляет "Lemon":

В следующем примере метод splice() удаляет один элемент по индексу 3:

В следующем примере метод splice() удаляет один элемент по индексу 2 и вставляет "Kiwi":

В следующем примере метод splice() удаляет два элемента начиная с индекса 0 и вставляет "Lemon", "Kiwi" и "Pear":

В следующем примере метод splice() удаляет все элементы после индекса 2 (включительно):