unshift()

Поддержка браузерами

Описание

Метод unshift() добавляет один или более элементов в начало массива и возвращает новую длину массива.

Индексы всех элементов, изначально присутствующих в массиве, увеличиваются на единицу (если методу был передан всего один аргумент) или на число, равное количеству переданных аргументов.

Метод unshift() изменяет исходный массив, а не создаёт его модифицированную копию.

Синтаксис

arr.unshift([element1[, ...[, elementN]]]);

Аргументы

elementN: Элементы, добавляемые в начало массива. Элементы добавляются в том порядке, в котором они были переданы методу.

Возвращаемое значение

Новое значение свойства length того массива, для которого был вызван метод.

Пример

<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Название веб-страницы</title>
</head>
<body>
<script>
"use strict";
let nums = [4, 5];
let total = nums.unshift(1, 2, 3);

console.log(nums);    // [1, 2, 3, 4, 5]
console.log(total);   // 5
</script>

</body>
</html>