Array.prototype.unshift()

Метод unshift() додає один або декілька елементів на початок масиву і повертає новий розмір масиву.

Синтаксис

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

Параметри

elementN

Елементи для додавання в початок масиву.

Результат

Нова властивість length об'єкту, для якого було викликано функцію.

Опис

Метод unshift вставляє задані значення в початок масиву.

Приклади

var arr = [1, 2];

arr.unshift(0); // результатом виклику буде значення 3, нова довжина масиву
// arr is [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr is [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr is [[-3], -2, -1, 0, 1, 2]

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

Браузерна сумісність

Дивись також

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