Encodera

Спасибо, что читаете!

Пожертвуйте сайту, мы стараемся ради вас.

Справочник JavaScript

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: создание, индексы, длина, изменение элементов и вложенные массивы.

Спасибо, что читаете!

Пожертвуйте сайту, мы стараемся ради вас.