JavaScript unshift() 方法

Array 对象参考手册 JavaScript Array 对象

将新项添加到数组起始位置:

<p id="demo">单击按钮在数组中插入元素。</p>
<button onclick="myFunction()">点我</button>
<script>
  function myFunction() {
    var fruits = ["Banana", "Orange", "Apple", "Mango"];
    fruits.unshift("Lemon", "Pineapple");
    var x = document.getElementById("demo");
    x.innerHTML = fruits;
  }
</script>
<p><b>注意:</b> unshift()方法不能用于 Internet Explorer 8 之前的版本,插入的值将被返回成<em> undefined </em>。</p>

尝试一下 »


定义和用法

unshift() 方法可向数组的开头添加一个或更多元素,并返回新的长度。

注意: 该方法将改变数组的数目。

提示: 将新项添加到数组末尾,请使用 push() 方法。


浏览器支持

Internet ExplorerFirefoxOperaGoogle ChromeSafari

所有主要浏览器都支持unshift()方法,Internet Explorer 8及更早IE版本不支持。

注意: unshift() 方法在Internet Explorer 8及更早IE版本返回undefined


语法

array.unshift(item1, item2, ..., itemX)

参数 Values

参数 描述
item1,item2, ..., itemX 可选。向数组起始位置添加一个或者多个元素。

返回值

Type 描述
Number 数组新长度

技术细节

JavaScript 版本: 1.2

Array 对象参考手册 JavaScript Array 对象