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]
Спецификации
Спецификация | Статус | Комментарии |
---|---|---|
ECMAScript 3-е издание. | Стандарт | Изначальное определение. Реализована в JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) Определение 'Array.prototype.unshift' в этой спецификации. |
Стандарт | |
ECMAScript 2015 (6th Edition, ECMA-262) Определение 'Array.prototype.unshift' в этой спецификации. |
Стандарт |
Совместимость с браузерами
BCD tables only load in the browser