JavaScript

Array.prototype.unshift()メソッド

→

配列の最初に 1 つ以上の要素を追加し、新しい配列の長さを返します。

戻り値： メソッドを呼び出した後のオブジェクトの新しい 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 ]

テスト