unshift (JavaScript)

配列の前に要素を追加します。

定義場所

Array (Standard - JavaScript)

構文

unshift(object:java.lang.Object, ...) : Object (JavaScript)[]
パラメータ 説明
object 新規エレメントの値。各パラメータは 1 つの新規要素を表します。
戻り値 説明
Object[] 新規の配列。

使用法

このメソッドでは、基本配列が変更されます。

以下の計算結果ラベルでは、2 つの要素が配列に追加されます。
var a = new Array("one", "two", "three");
a.unshift("minus one", "zero");
var display = "";
for(var i=0; i<a.length; i++) {
	display = display + a[i] + ", ";
}
display = display.left(display.length - 2);
display // minus one, zero, one, two, three