JavaScript unshift() 方法

Array 对象参考手册 JavaScript Array 对象

实例

将新项添加到数组起始位置:

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

fruits 将输出:

Lemon,Pineapple,Banana,Orange,Apple,Mango

定义和用法

unshift() 方法可向数组的开头添加一个或更多元素,并返回新的长度。

注意: 该方法将改变数组的数目。

提示: 将新项添加到数组末尾,请使用 push() 方法。


浏览器支持

Internet ExplorerFirefoxOperaGoogle ChromeSafari

所有主要浏览器都支持unshift()方法,Internet Explorer 8及更早IE版本不支持。

注意: unshift() 方法在Internet Explorer 8及更早IE版本返回undefined


语法

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

参数 Values

参数 描述
item1,item2, ..., itemX 可选。向数组起始位置添加一个或者多个元素。

返回值

Type 描述 Number 数组新长度

技术细节

JavaScript 版本: 1.2


Array 对象参考手册 JavaScript Array 对象