JavaScript Array unshift() メソッド

定義と使用法

unshift() メソッドは新しいアイテムを配列の先頭に追加し、新しい長さを返します。

注記：unshift() メソッドは配列の長さを変更します。

ヒント：配列の末尾に新しいアイテムを追加するには、 push() メソッド。

例

新しいプロジェクトを配列の先頭に追加：

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.unshift("Lemon","Pineapple");

実際に試してみる

文法

array.unshift(item1, item2, ... , itemX)

パラメータの値

パラメータ 説明
item1, item2, ... , itemX 必要。配列の先頭に追加する項目。

技術的詳細

返り値： 数値、配列の新しい長さを表す。
JavaScript バージョン： ECMAScript 1

ブラウザサポート

すべてのブラウザが完全にサポートしています unshift() メソッド：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート サポート サポート サポート サポート サポート

注記：Internet Explorer 8およびそれ以前のバージョンでは、unshift()メソッドはundefinedを返します。

関連ページ

チュートリアル：JavaScript 配列

チュートリアル：JavaScript 配列 Const

チュートリアル：JavaScript 配列メソッド

チュートリアル：JavaScript 配列のソート

チュートリアル：JavaScript 配列のイテレーション

マニュアル：JavaScript Array.push() メソッド

マニュアル：JavaScript Array.pop() メソッド

マニュアル：JavaScript Array.shift() メソッド