CodePlayer

unshift()函数用于向当前数组的开头位置插入一个或多个指定的元素，并返回插入后的数组长度。

该函数属于Array对象，IE 5.5+、FireFox、Chrome、Safari、Opera等主流浏览器均支持该函数。

语法

array.unshift( item1 [,items... ] )

参数

返回值

unshift()函数的返回值为Number类型，返回插入元素后的当前数组的长度。

当向数组中添加新的元素时，数组的length属性也会随之改变(如果数组中有元素的话)，一般而言，数组的length属性将会加N(N为添加的元素个数)。

注意：unshift()函数在 IE 5.5 ~ IE 7 浏览器中的返回值为undefined，只有IE 8+可以正确返回插入后的数组长度。出于兼容性考虑，如需获取新的数组长度，请直接使用array.length，而不要使用该函数的返回值。

示例&说明

// 定义一个数组等同的对象
var array = ["Java", true, "PHP"];

var newLength = array.unshift("张三", "李四");
document.writeln( newLength ); // 5
document.writeln( array ); // 张三,李四,Java,true,PHP

newLength = array.unshift(true, ["王五", 5] );
document.writeln( newLength ); // 7
//这里输出的"王五,5"是一个元素，只不过该元素是数组类型
document.writeln( array ); // true,王五,5,张三,李四,Java,true,PHP

运行代码