Array.prototype.unshift()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Сводка
Методunshift() добавляет один или более элементов в начало массива и возвращает новую длину массива.
Синтаксис
arr.unshift(element1[, ...[, elementN]])
Параметры
element1, ..., elementNЭлементы, добавляемые в начало массива.
Возвращаемое значение
Новое свойствоlength объекта, над которым был вызван методunshift.
Описание
Методunshift вставляет переданные значения в начало массивоподобного объекта.
Методunshift не является привязанным к типу; этот метод может бытьвызван илиприменён к объектам, напоминающим массив. Объекты, не содержащие свойствоlength, отражающее последний элемент в серии последовательных числовых, начинающихся с нуля, свойств, могут повести себя неправильным образом.
Примеры
js
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]Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.unshift |