Array.prototype.unshift()

Сводка

Метод unshift() добавляет один или более элементов в начало массива и возвращает новую длину массива.

Синтаксис

arr.unshift([element1[, ...[, elementN]]])

Параметры

element1, ..., elementN

Необязательные параметры. Элементы, добавляемые в начало массива.

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

Новое свойство length объекта, над которым был вызван метод unshift.

Описание

Метод unshift вставляет переданные значения в начало массивоподобного объекта.

Метод unshift не является привязанным к типу; этот метод может быть вызван или применён к объектам, напоминающим массив. Объекты, не содержащие свойство length, отражающее последний элемент в серии последовательных числовых, начинающихся с нуля, свойств, могут повести себя неправильным образом.

Примеры

var arr = [1, 2];

arr.unshift(0); // результат вызова равен 3, новой длине массива
// arr равен [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr равен [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr равен[[-3], -2, -1, 0, 1, 2]

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

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

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

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.shift()