Метод unshift()
додає один або декілька елементів на початок масиву і повертає новий розмір масиву.
Синтаксис
arr.unshift([element1[, ...[, elementN]]])
Параметри
elementN
- Елементи для додавання в початок масиву.
Результат
Нова властивість length
об'єкту, для якого було викликано функцію.
Опис
Метод unshift
вставляє задані значення в початок масиву.
Метод unshift
є навмисно загальним; він може бути викликаний або застосований у об'єктах, схожих на масиви. Об'єкти, які не мають властивості length
, що відображає останню з серії послідовних числових властивостей, що починаються з нуля, можуть поводитися непередбачувано.
Будь ласка, зауважте, якщо у параметри передається більше одного значення, вони всі вставляються на початку об'єкта, саме в тому порядку, в якому були передані у параметри. Отже, виклик unshift з n аргументів за один раз, або виклик n разів з 1 аргументом (наприклад, у циклі), не дадуть однаковий результат. Наприклад:
let arr = [4, 5, 6];
arr.unshift(1, 2, 3);
console.log(arr);
// [1, 2, 3, 4, 5, 6]
arr = [4, 5, 6]; // скидаємо значення масиву
arr.unshift(1);
arr.unshift(2);
arr.unshift(3);
console.log(arr);
// [3, 2, 1, 4, 5, 6]
Приклади
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([-4, -3]); // нова довжина масиву дорівнює 6
// arr дорівнбє [[-4, -3], -2, -1, 0, 1, 2]
arr.unshift([-7, -6], [-5]); // нова довжина масиву дорівнює 8
// arr дорівнює [ [-7, -6], [-5], [-4, -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 (ECMA-262) The definition of 'Array.prototype.unshift' in that specification. |
Living Standard |
Сумісність з веб-переглядачами
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.