Array.prototype.unshift()

概述

unshift() 方法在数组的开头添加一个或者多个元素,并返回数组新的 length 值。

语法

arr.unshift(element1, ..., elementN)

参数列表

element1, ..., elementN
要添加到数组开头的元素。

返回值

当一个对象调用该方法时,返回其 length 属性值。

描述

unshift 方法会在调用它的类数组(array-like)对象的开始位置插入给定的参数。

unshift 特意被设计成具有通用性;这个方法能够通过 callapply 方法作用于类似数组的对象上。不过对于没有 length 属性(代表从0开始的一系列连续的数字属性的最后一个)的对象,调用该方法可能没有任何意义。

例子

var arr = [1, 2];

arr.unshift(0); //result of call is 3, the new array length
//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 Standard Initial definition.
Implemented in JavaScript 1.2
ECMAScript 5.1 (ECMA-262)
Array.prototype.unshift
Standard  
ECMAScript 6 (ECMA-262)
Array.prototype.unshift
Release Candidate  

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

相关链接

文档标签和贡献者

向此页面作出贡献: AlexChao, ziyunfei, teoli, xfeng
最后编辑者: AlexChao,
隐藏侧边栏