JavaScript - 配列の最初（先頭）に追加する unshift() メソッド

JavaScript で配列の最初（先頭）に要素を追加する場合は、 unshift() メソッドを使います。

unshift() メソッドは配列の先頭に１つまたは複数の値を追加できます。

unshift() の戻り値は、追加後の新しい配列の要素数です。

unshift() メソッドのサンプルコード

最初に値を1つ追加し、次に複数追加しています。

var arr = [1,3,10];

arr.unshift(8);       // 1つ追加

console.log(arr);  // Array [ 8, 1, 3, 10 ]

var re = arr.unshift(2, 4);   // 複数追加

console.log(arr);  // Array [ 2, 4, 8, 1, 3, 10 ]

console.log(re);   // 6  新しい配列の要素数

push(), pop(), unshift(), shift() の違い

一緒に使われることが多い push(), pop(), unshift(), shift() の違いは 下表の通りです。

push()	末尾に追加
pop()	末尾を削除
unshift()	先頭に追加
shift()	先頭を削除