Array.prototype.unshift()
unshift()
方法會添加一個或多個元素至陣列的開頭,並且回傳陣列的新長度。
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
語法
arr.unshift(element1[, ...[, elementN]])
參數
elementN
- 欲添加至陣列開頭的元素。
回傳值
呼叫此方法之物件的新 length
屬性值。
描述
unshift
方法會將一或多個給定值插入至一個類陣列(array-like)物件的開頭。
unshift
被刻意設計為具通用性;此方法可以藉由 called 或 applied 應用於類似陣列的物件上。若欲應用此方法的物件不包含代表一系列啟始為零之數字屬性序列長度的 length
屬性,可能是不具任何意義的行為。
範例
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 | Status | Comment |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) The definition of 'Array.prototype.unshift' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype.unshift' in that specification. |
Standard | |
ECMAScript (ECMA-262) The definition of 'Array.prototype.unshift' in that specification. |
Living Standard |
瀏覽器相容性
BCD tables only load in the browser