JavaScript Array unshift() 方法

定义和用法

unshift() 方法将新项添加到数组的开头，并返回新的长度。

注释：unshift() 方法会改变数组的长度。

提示：如需在数组末尾添加新项，请使用 push() 方法。

实例

将新项目添加到数组的开头：

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.unshift("Lemon","Pineapple");

亲自试一试

语法

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

参数值

参数 描述
item1, item2, ..., itemX 必需。要添加到数组开头的项。

技术细节

返回值： 数值，表示数组的新长度。
JavaScript 版本： ECMAScript 1

浏览器支持

所有浏览器都完全支持 unshift() 方法：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持

注释：在 Internet Explorer 8 及更早版本中，unshift() 方法返回 undefined。

相关页面

教程：JavaScript 数组

教程：JavaScript 数组 Const

教程：JavaScript 数组方法

教程：JavaScript 排序数组

教程：JavaScript 数组迭代

手册：JavaScript Array.push() 方法

手册：JavaScript Array.pop() 方法

手册：JavaScript Array.shift() 方法