unshift() 方法用來把一個或多個元素添加到陣列的「開頭」,並回傳該陣列的新長度。它與在尾端添加元素的 push() 恰好相反。
array.unshift(element1, ..., elementN);
參數說明:
・element1, ..., elementN:要添加到陣列前面的元素。
回傳新陣列的長度。(在舊版 IE 中可能回傳 undefined。)
<html>
<head>
<title>JavaScript Array unshift Method</title>
</head>
<body>
<script type="text/javascript">
var arr = new Array("orange", "mango", "banana", "sugar");
var length = arr.unshift("water");
document.write("Returned array is : " + arr);
document.write("<br /> Length of the array is : " + length);
</script>
</body>
</html>
執行後會輸出:
Returned array is : water,orange,mango,banana,sugar
Length of the array is : 5
可以看到 "water" 被加到了最前面,陣列長度從 4 變成 5。若一次傳入多個元素,它們會依參數順序被插入到開頭。搭配 push()(尾端添加)、pop()(尾端移除)與 shift()(開頭移除),就能靈活操作陣列的兩端。