語法與回傳值
arr.push(element1, element2, ..., elementN)
// 回傳:陣列新長度(Number)
// 特性:直接修改原陣列(非純函式),非建立新陣列
基本範例
var fruits = ['蘋果', '香蕉'];
var len = fruits.push('橘子', '葡萄');
console.log(fruits); // ['蘋果', '香蕉', '橘子', '葡萄']
console.log(len); // 4
實戰:收集勾選的核取方塊值
<input type="checkbox" name="fruit" value="apple" checked> 蘋果
<input type="checkbox" name="fruit" value="banana"> 香蕉
<input type="checkbox" name="fruit" value="orange" checked> 橘子
<button id="btn">取得選中值</button>
<script>
document.getElementById('btn').onclick = function() {
var selected = [];
var checkboxes = document.getElementsByName('fruit');
for (var i = 0; i < checkboxes.length; i++) {
if (checkboxes[i].checked) {
selected.push(checkboxes[i].value);
}
}
console.log('選中的水果:', selected); // ['apple', 'orange']
console.log('數量:', selected.length);
};
</script>
進階用法
1. 合併陣列(ES6 展開運算子更優雅)
var a = [1, 2], b = [3, 4];
a.push.apply(a, b); // 老寫法,a 變 [1,2,3,4]
// 現代寫法
a.push(...b); // 同樣效果,可讀性更好
2. 類陣列物件轉陣列並推入
var args = (function() { return arguments; })(1, 2, 3);
var arr = [];
arr.push.apply(arr, args); // arr = [1,2,3]
// 現代:Array.from(args) 或 [...args]
3. 模擬堆疊
var stack = [];
stack.push('first');
stack.push('second');
stack.pop(); // 'second' —— 後進先出 (LIFO)
效能與記憶體考量
push 為 O(1) 擴攤攤銷時間複雜度,極快。
- 大量資料(>10 萬筆)建議預先分配長度
arr.length = N 或分批處理,避免頻繁記憶體重分配。
- 函數式寫法偏好
concat、[...a, ...b] 產生新陣列,利於不可變資料流(Redux 等)。
常見錯誤
// 錯誤:push 回傳長度,非新陣列
var newArr = arr.push(1); // newArr = 3 (長度),非 [..,1]
// 正確
arr.push(1);
var newArr = arr.slice(); // 複本
// 或
var newArr = [...arr, 1]; // 新陣列