Array.prototype.unshift()

unshift() メソッドは、配列の最初に 1 つ以上の要素を追加し、新しい配列の長さを返します。

構文

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

引数

elementN
配列の先頭に追加する要素。

戻り値

メソッドが呼び出し後の length プロパティの値

説明

unshift メソッドは与えられた要素を配列のようなオブジェクトの一番最初に挿入します。

unshift は意図して汎用的です。つまり、このメソッドは配列に類似したオブジェクトに対して called したり applied したりすることができます。ゼロから始まる数値プロパティであり、連続した連なりの最後を反映している length プロパティを含まないオブジェクトでは効果がないかもしれません。

例

var arr = [1, 2];

arr.unshift(0); // result of call is 3, the new array length
// arr is [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr is [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr is [[-3], -2, -1, 0, 1, 2]

仕様

仕様 ステータス コメント
ECMAScript 3rd Edition (ECMA-262) 標準 初期定義。JavaScript 1.2 で実装。
ECMAScript 5.1 (ECMA-262)
Array.prototype.unshift の定義		 標準  
ECMAScript 2015 (6th Edition, ECMA-262)
Array.prototype.unshift の定義		 標準  
ECMAScript (ECMA-262)
Array.prototype.unshift の定義		 現行の標準  

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
unshiftChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 5.5Opera 完全対応 4Safari 完全対応 1WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 0.1.100

凡例

完全対応  
完全対応

関連情報

関連トピック
  1. Standard built-in objects
  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()