JavaScript Array unshift() 方法

定義和用法

unshift() 方法將新項添加到數組的開頭，并返回新的長度。

注釋：unshift() 方法會改變數組的長度。

提示：如需在數組末尾添加新項，請使用 push() 方法。

實例

將新項目添加到數組的開頭：

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

親自試一試

語法

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

參數值

參數 描述
item1, item2, ..., itemX 必需。要添加到數組開頭的項。

技術細節

返回值： 數值，表示數組的新長度。
JavaScript 版本： ECMAScript 1

瀏覽器支持

所有瀏覽器都完全支持 unshift() 方法：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持

注釋：在 Internet Explorer 8 及更早版本中，unshift() 方法返回 undefined。

相關頁面

教程：JavaScript 數組

教程：JavaScript 數組 Const

教程：JavaScript 數組方法

教程：JavaScript 排序數組

教程：JavaScript 數組迭代

手冊：JavaScript Array.push() 方法

手冊：JavaScript Array.pop() 方法

手冊：JavaScript Array.shift() 方法