Array.prototype.unshift()

Сводка

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

Синтаксис

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

Параметры

element1, ..., elementN
Необязательные параметры. Элементы, добавляемые в начало массива.

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

Новое свойство length объекта, над которым был вызван метод unshift.

Описание

Метод unshift вставляет переданные значения в начало массивоподобного объекта.

Метод unshift не является привязанным к типу; этот метод может быть вызван или применён к объектам, напоминающим массив. Объекты, не содержащие свойство length, отражающее последний элемент в серии последовательных числовых, начинающихся с нуля, свойств, могут повести себя неправильным образом.

Примеры

var arr = [1, 2];

arr.unshift(0); // результат вызова равен 3, новой длине массива
// arr равен [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr равен [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr равен[[-3], -2, -1, 0, 1, 2]

Спецификации

Спецификация Статус Комментарии
ECMAScript 3-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
Определение 'Array.prototype.unshift' в этой спецификации.		 Стандарт
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Array.prototype.unshift' в этой спецификации.		 Стандарт

Совместимость с браузерами

Update compatibility data on GitHub
КомпьютерыМобильныеServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung InternetNode.js
unshiftChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка 5.5Opera Полная поддержка 4Safari Полная поддержка 1WebView Android Полная поддержка 1Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка 10.1Safari iOS Полная поддержка 1Samsung Internet Android Полная поддержка Даnodejs Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка

Смотрите также

Связанные темы
  1. Стандартные встроенные объекты
  2. Array
  3. Свойства
    1. Array.length
    2. Array.prototype[@@unscopables]
  4. Методы
    1. Array.from()
    2. Array.isArray()
    3. Array.observe()
    4. Array.of()
    5. Array.prototype.concat()
    6. Array.prototype.copyWithin()
    7. Array.prototype.entries()
    8. Array.prototype.every()
    9. Array.prototype.fill()
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex()
    13. Array.prototype.flat()
    14. Array.prototype.flatMap()
    15. Array.prototype.forEach()
    16. Array.prototype.includes()
    17. Array.prototype.indexOf()
    18. Array.prototype.join()
    19. Array.prototype.keys()
    20. Array.prototype.lastIndexOf()
    21. Array.prototype.map()
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce()
    25. Array.prototype.reduceRight()
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice()
    29. Array.prototype.some()
    30. Array.prototype.sort()
    31. Array.prototype.splice()
    32. Array.prototype.toLocaleString()
    33. Array.prototype.toSource()
    34. Array.prototype.toString()
    35. Array.prototype.unshift()
    36. Array.prototype.values()
    37. Array.prototype[@@iterator]()
    38. Array.unobserve() [Перевести]
    39. get Array[@@species]
  5. Наследование:
  6. Function
  7. Свойства
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
  8. Методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Свойства
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Методы
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()