Array.prototype.unshift() 是數組方法中專門用於在數組開頭添加一個或多個元素的方法,並返回新數組的長度。本文詳細講解其語法、行為特性、瀏覽器差異及實戰應用。
array.unshift(element1[, element2[, ...[, elementN]]])
var arr = ["orange", "mango", "banana", "sugar"];
var length = arr.unshift("water");
console.log(arr); // ["water", "orange", "mango", "banana", "sugar"]
console.log(length); // 5
var arr = [3, 4];
arr.unshift(1, 2); // 一次插入多個
console.log(arr); // [1, 2, 3, 4]
| 環境 | 返回值 |
|---|---|
| 現代瀏覽器 (ES2013+) | 新數組長度 (Number) |
| IE 8 及更早 | undefined |
最佳實踐: 不要依賴返回值進行鏈式調用或邏輯判斷,僅用於獲取長度信息。
| 方法 | 位置 | 修改原數組 | 返回值 | 典型用途 |
|---|---|---|---|---|
| unshift | 首部 | ✅ | 新長度 (IE8- undefined) | 隊列入隊、優先插入 |
| push | 尾部 | ✅ | 新長度 | 棧入棧、隊列入隊 |
| shift | 首部 | ✅ | 被刪除元素 | 隊列出隊 |
| pop | 尾部 | ✅ | 被刪除元素 | 棧出棧 |
| splice(0,0,...) | 首部 | ✅ | [] | 通用插入、批量操作 |
class Queue {
constructor() { this.items = []; }
enqueue(item) { this.items.push(item); } // 尾部入隊
dequeue() { return this.items.shift(); } // 首部出隊
front() { return this.items[0]; }
isEmpty() { return this.items.length === 0; }
}
var logs = [];
function addLog(message) {
logs.unshift({ time: Date.now(), message });
if (logs.length > 100) logs.pop(); // 保留最近100條
}
var undoStack = [];
var redoStack = [];
function doAction(action) {
undoStack.unshift(action); // 最新操作在首部
redoStack.length = 0; // 清空重做棧
}
<html>
<head><title>JavaScript Array unshift Method</title></head>
<body>
<script>
var arr = new Array("orange", "mango", "banana", "sugar");
var length = arr.unshift("water");
document.write("Returned array is : " + arr + "<br>Length of the array is : " + length);
</script>
</body>
</html>
輸出:
Returned array is : water,orange,mango,banana,sugar
Length of the array is : 5