JavaScript Array shift() Method

Below is the example of Array shift() method.

  • Example:
    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    <script>
    function func() { 
          
        // Original array 
        var array = ["GFG", "Geeks", "for", "Geeks"]; 
      
        // Checking for condition in array 
        var value = array.shift(); 
      
        document.write(value);
        document.write("<br />"); 
        document.write(array); 
      
    func();
    </script>

    chevron_right

    
    

  • Output:
    GFG
    Geeks, for, Geeks

The arr.shift() method removes the first element of the array thus reducing the size of the original array by 1.

Syntax:

arr.shift()

Parameters: This method does not accept any parameter.

Return value: This function returns the removed first element of the array. If the array is empty then this function returns undefined.



Note: This function can also be used with other javascript objects that behave like the array.

Below examples illustrate the JavaScript Array shift() method:

  • Example 1: In this example the shift() method removes the first element of the array, therefore it returns 34.
    var arr = [2, 5, 8, 1, 4];
    document.write(value);
    document.write(arr);
    

    Output:

    34
    234,567,4
    
  • Example 2: In this example the shift() method tries to remove the first element of the array, but the array is empty, therefore it returns undefined.
    var arr = [];
    document.write(value);
    document.write(arr)
    

    Output:

    undefined

Code for the above method is provided below:

Program 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

<script> 
function func() { 
      
    // Original array 
    var array = [34,234,567,4]; 
  
    // Checking for condition in array 
    var value = array.shift(); 
  
    document.write(value);
    document.write("<br />"); 
    document.write(array); 
  
func(); 
</script> 

chevron_right


Output:

34
234,567,4

Program 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

<script>
function func() { 
      
    // Original array 
    var array = []; 
  
    // Checking for condition in array 
    var value = array.shift(); 
  
    document.write(value);
    document.write("<br />"); 
    document.write(array); 
  
func();
</script>

chevron_right


Output:

undefined

Supported Browsers: The browsers supported by JavaScript Array shift() method are listed below:

  • Google Chrome
  • Microsoft Edge
  • Mozilla Firefox
  • Safari
  • Opera

full-stack-img




My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.