MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

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

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

Назва специфікації Статус Коментарій
ECMAScript 3rd Edition (ECMA-262) Standard Початкове визначення. Реалізовано в JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.unshift' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.unshift' in that specification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
The definition of 'Array.prototype.unshift' in that specification.
Draft  

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

Тип підтримки Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базова підтримка 1.0 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Тип підтримки Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базова підтримка (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Дивись також

Мітки документа й учасники

 Зробили внесок у цю сторінку: Kamilius, ValkoVolodya
 Востаннє оновлена: Kamilius,