Array.prototype.unshift
Добавляет элементы в начало массива.
Доступно с: ES3
Синтаксис
array.unshift(element1, element2, /* … */)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| element1, … | any | Элементы, которые добавляются в начало. |
Возвращаемое значение
numberНовая длина массива.
Примеры
Добавление в начало:
const list = ['b', 'c'];
list.unshift('a');
console.log(list);Результат:
[
"a",
"b",
"c"
]Метод возвращает новую длину, а не массив:
const list = ['c'];
console.log(list.unshift('a', 'b'));
console.log(list.join(''));Результат:
3
abcПримечания
Метод меняет сам массив. Чтобы получить новый массив, не трогая старый, используйте spread: ['a', ...list].
См. также
- Array.prototype.shift — Удаляет первый элемент массива и возвращает его.
- Array.prototype.push — Добавляет элементы в конец массива.
Вопросы и ответы по теме
В учебнике
- Массивы — Что такое массив в JavaScript: создание, индексы, длина, изменение элементов и вложенные массивы.