We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

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

ブラウザ実装状況

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応1 あり15.5 あり あり
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応 あり あり あり4 あり あり あり

関連情報

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

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