MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

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 2017 Draft (ECMA-262)
Array.prototype.unshift の定義
ドラフト  

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 1.0 1.0 (1.7 or earlier) 5.5 (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: YuichiNukiyama, teoli, ethertank, Potappo, Shoot, Mgjbot, Yuichirou
 最終更新者: YuichiNukiyama,