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 對象