在线文档教程

array.shift

array.shift

shift()方法从数组中删除第一个元素,并返回该元素的值。此方法更改数组的长度。

var a = [1, 2, 3]; var b = a.shift( console.log(a // [2, 3] console.log(b // 1

语法

arr.shift()

返回值

从数组中删除的元素; 如果数组为空则返回undefined。 

描述

shift方法移除索引为 0 的元素(即第一个元素),并返回被移除的元素,其他元素的索引值随之减 1。如果length属性的值为 0 (长度为 0),则返回undefined

shift方法并不局限于数组:这个方法能够通过 callapply 方法作用于类似数组的对象上。但是对于没有 length 属性(从0开始的一系列连续的数字属性的最后一个)的对象,调用该方法可能没有任何意义。

示例

移除数组中的一个元素

以下代码显示了删除其第一个元素之前和之后的myFish数组。它还显示已删除的元素:

var myFish = ['angel', 'clown', 'mandarin', 'surgeon']; console.log('myFish before:', JSON.stringify(myFish) // myFish before: ['angel', 'clown', 'mandarin', 'surgeon'] var shifted = myFish.shift( console.log('myFish after:', myFish // myFish after: ['clown', 'mandarin', 'surgeon'] console.log('Removed this element:', shifted // Removed this element: angel

规范

SpecificationStatusComment
ECMAScript 3rd Edition (ECMA-262)StandardInitial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)The definition of 'Array.prototype.shift' in that specification.Standard
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'Array.prototype.shift' in that specification.Standard
ECMAScript Latest Draft (ECMA-262)The definition of 'Array.prototype.shift' in that specification.Living Standard

浏览器兼容性

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support1(Yes)15.5(Yes)(Yes)

FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)(Yes)(Yes)1(Yes)(Yes)(Yes)