Сводка

Метод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()