push() 是 JavaScript 陣列最常用的方法之一,用於在陣列「末尾」新增一個或多個元素,並回傳新的陣列長度。本文將透過實例詳細說明其語法、行為與注意事項。
arr.push(element1, element2, ..., elementN)
const fruits = ['Banana', 'Orange', 'Apple', 'Mango'];
fruits.push('Kiwi');
console.log(fruits); // ["Banana", "Orange", "Apple", "Mango", "Kiwi"]
const colors = ['Red', 'Green'];
colors.push('Blue', 'Yellow', 'Black');
console.log(colors); // ["Red", "Green", "Blue", "Yellow", "Black"]
console.log(colors.length); // 5
<!DOCTYPE html>
<html>
<body>
<p id="demo">點擊按鈕新增元素</p>
<button onclick="addItem()">新增</button>
<script>
const fruits = ['Banana', 'Orange', 'Apple', 'Mango'];
function addItem() {
fruits.push('jb51.net');
document.getElementById('demo').innerHTML = fruits.join(', ');
}
</script>
</body>
</html>
執行後畫面將顯示:Banana, Orange, Apple, Mango, jb51.net
push() 透過 length 屬性決定插入位置,因此也可透過 call 或 apply 用於類陣列物件:
const obj = { 0: 'a', 1: 'b', length: 2 };
Array.prototype.push.call(obj, 'c');
console.log(obj); // { 0: 'a', 1: 'b', 2: 'c', length: 3 }
若需保留原陣列,請先複製:const newArr = [...oldArr, newItem] 或 oldArr.concat(newItem)。
const arr = [1,2];
const len = arr.push(3);
console.log(len); // 3
console.log(arr); // [1,2,3]
| 方法 | 位置 | 是否修改原陣列 | 回傳值 |
|---|---|---|---|
| push | 末尾 | 是 | 新長度 |
| unshift | 開頭 | 是 | 新長度 |
| concat | 任意(建新陣列) | 否 | 新陣列 |
| splice | 指定索引 | 是 | 被刪除元素組成的陣列 |
push() 是陣列尾端新增資料的首選方法,語法簡潔、效能良好,廣泛應用於資料蒐集、堆疊模擬等場景。記住它會直接修改原陣列並回傳新長度即可避開常見錯誤。