此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。
Array.prototype.unshift()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
unshift() 方法會添加一個或多個元素至陣列的開頭，並且回傳陣列的新長度。
嘗試一下
const array1 = [1, 2, 3];console.log(array1.unshift(4, 5));// Expected output: 5console.log(array1);// Expected output: Array [4, 5, 1, 2, 3]語法
arr.unshift(element1[, ...[, elementN]])
參數
elementN欲添加至陣列開頭的元素。
回傳值
呼叫此方法之物件的新length 屬性值。
描述
unshift 方法會將一或多個給定值插入至一個類陣列（array-like）物件的開頭。
unshift 被刻意設計為具通用性；此方法可以藉由called 或applied 應用於類似陣列的物件上。若欲應用此方法的物件不包含代表一系列啟始為零之數字屬性序列長度的length 屬性，可能是不具任何意義的行為。
範例
js
var arr = [1, 2];arr.unshift(0); // 執行後的結果是3，其代表處理後的陣列長度// arr is [0, 1, 2]arr.unshift(-2, -1); // = 5// arr is [-2, -1, 0, 1, 2]arr.unshift([-3]);// arr is [[-3], -2, -1, 0, 1, 2]規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.unshift |