JavaScript

Array.prototype.unshift()メソッド

→

その Array の最初に指定の要素を追加し、処理後の Array の長さを返します。元の Array は更新されます。

戻り値

メソッドを呼び出した後のオブジェクトの新しい length プロパティの値。

unshift は意図して汎用的です。このメソッドは、配列に類似したオブジェクトに対して呼び出したり、適用したりすることができます。length プロパティ、すなわち連続の最後を示すゼロベースの数値プロパティ、を反映しているため、意味のある振る舞いができない可能性があります。

複数の要素が引数として渡された場合、引数として渡されたものと全く同じ順番で、オブジェクトの最初のチャンクに挿入されることに注意してください。したがって、unshift を n 個の引数で1回呼び出すのと、1個の引数で n 回（例えばループを使って）呼び出すのとでは同じ結果にはなりません。

例

let arr = [4, 5, 6];
D=arr.unshift(1, 2, 3); //＝6
D=arr; //＝[1, 2, 3, 4, 5, 6]

arr = [4, 5, 6];
D=arr.unshift(1); //＝4
D=arr.unshift(2); //＝5
D=arr.unshift(3); //＝6
D=arr; //＝[3, 2, 1, 4, 5, 6]

let arr = [1, 2];
D=arr.unshift(0); //＝3
D=arr; //＝[0, 1, 2]

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

let arr = [1, 2];
D=arr.unshift([10, 20], [30]); //＝4
D=arr; //＝[ [10, 20], [30], 1, 2 ]

テスト