Section 24.13. Array.shift( ): shift array elements down

24.13. Array.shift( ): shift array elements down

ECMAScript v3

24.13.1. Synopsis

 array.shift( ) 

24.13.1.1. Returns

The former first element of the array.

24.13.2. Description

shift( ) removes and returns the first element of array, shifting all subsequent elements down one place to occupy the newly vacant space at the start of the array. If the array is empty, shift( ) does nothing and returns the undefined value. Note that shift( ) does not create a new array; instead, it modifies array directly.

shift( ) is similar to Array.pop( ), except it operates on the beginning of an array rather than the end. shift( ) is often used in conjunction with unshift( ).

24.13.3. Example

 var a = [1, [2,3], 4] a.shift( );  // Returns 1; a = [[2,3], 4] a.shift( );  // Returns [2,3]; a = [4] 

24.13.4. See Also

 Array.pop( ), Array.unshift( )