JavaScript Array push() 方法

定義和用法

push() 方法向數組末尾添加新項目，并返回新長度。

提示：新的項目將被添加到數組的末尾。

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

提示：如需在數組的開頭添加項目，請使用 unshift() 方法。

實例

例子 1

向數組添加一個新項目：

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.push("Kiwi");

親自試一試

例子 2

添加多個項目：

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

親自試一試

例子 3

push() 返回新的長度：

const fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.push("Kiwi");   // 返回 5

親自試一試

語法

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

參數值

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

技術細節

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

瀏覽器支持

表格中的數字注明了完全支持該方法的首個瀏覽器版本。

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

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

相關頁面

教程：JavaScript 數組

教程：JavaScript 數組 Const

教程：JavaScript 數組方法

教程：JavaScript 排序數組

教程：JavaScript 數組迭代

手冊：JavaScript pop() 方法

手冊：JavaScript shift() 方法

手冊：JavaScript unshift() 方法