JS метод Array.unshift()
Опис
Метод unshift() дозволяє додавати один або декілька елементів на початок масиву. Це дещо відрізняє його від методу Array.prototype.push(), який також додає елементи, але розміщує їх в кінці масиву.
Зверніть увагу: якщо ви передаєте кілька елементів одразу, вони будуть розміщені на початку масиву в порядку, в якому вони були передані. Це означає, що використання unshift() з n аргументами одночасно відзначається від n послідовних викликів цього методу з 1 аргументом, наприклад, виконаних у циклі.
Приклад:
let fruits = ["apple", "banana"];
fruits.unshift("orange", "lemon");
console.log(fruits); // Output: ["orange", "lemon", "apple", "banana"]
У цьому прикладі метод unshift() додає orange і lemon на початок масиву, розширюючи його до чотирьох елементів. Зверніть увагу на порядок елементів у результуючому масиві.
| Порада: | Метод |
| Нотатка: | Важливо враховувати, що при додаванні багатьох елементів за один раз застосовується порядок, в якому вони передаються у методі |
| Нотатка: | Метод |
| Нотатка: | Хоча рядки також подібні до масивів, цей метод не підходить для їх застосування, оскільки рядки є незмінними. |
Синтаксис
unshift()
unshift(element0)
unshift(element0, element1)
unshift(element0, element1, /* … ,*/ elementN)
Параметри
- *
elementN Елементи, які треба додати на початок масиву.
Return
Переглядачі
| Переглядач | |||||
|---|---|---|---|---|---|
1 |
1 |
1 |
4 |
12 |
| Переглядач | ||||
|---|---|---|---|---|
4.4 |
18 |
4 |
1 |
| Переглядач | ||
|---|---|---|
0.10.0 |
1.0 |
Приклади
Цей приклад показує, як метод unshift() можна використовувати для додавання нових елементів на початок масиву. Нові елементи генеруються випадковим чином.
Використання unshift().
const 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 ]
Виклик unshift() на не-масивних об'єктах.
const arrayLike = {
length: 3,
unrelated: "foo",
2: 4,
};
Array.prototype.unshift.call(arrayLike, 1, 2);
console.log(arrayLike);
// { '0': 1, '1': 2, '4': 4, length: 5, unrelated: 'foo' }
const plainObj = {};
// Немає властивості length, тому довжина дорівнює 0
Array.prototype.unshift.call(plainObj, 1, 2);
console.log(plainObj);
// { '0': 1, '1': 2, length: 2 }