Метод unshift добавляет любое количество новых элементов в начало массива.

Метод изменяет исходный массив. Возвращает новую длину массива.

См. также метод push, который добавляет элементы в конец массива.

См. также методы shift и pop, которые удаляют элементы из массива.

Синтаксис

массив.unshift(элемент, элемент, элемент...);

Примеры

Пример

В данном примере в начало исходного массива было добавлено еще 2 новых элемента и выведен уже новый, измененный массив:

var arr = ['a', 'b', 'c'];
arr.unshift('d', 'e');
console.log(arr);

Результат выполнения кода:

['a', 'b', 'c', 'd', 'e']

Пример

В данном примере в начало исходного массива было добавлено еще 2 новых элемента и выведена новая длина массива:

var arr = ['a', 'b', 'c'];
var length = arr.unshift('d', 'e');
document.write(length);

Результат выполнения кода:

5