JavaScript - Método Array unshift ()

Descrição

Array Javascript unshift() método adiciona um ou mais elementos ao início de uma matriz e retorna o novo comprimento da matriz.

Sintaxe

Sua sintaxe é a seguinte -

array.unshift( element1, ..., elementN );

Detalhes de Parâmetro

element1, ..., elementN - Os elementos a serem adicionados à frente da matriz.

Valor de retorno

Retorna o comprimento da nova matriz. Retornaundefined no navegador IE.

Exemplo

Experimente o seguinte exemplo.

<html>
   <head>
      <title>JavaScript Array unshift Method</title>
   </head>
   
   <body>   
      <script type = "text/javascript">
         var arr = new Array("orange", "mango", "banana", "sugar");         
         var length = arr.unshift("water");
         document.write("Returned array is : " + arr );
         document.write("<br /> Length of the array is : " + length );
      </script>      
   </body>
</html>

Resultado

Returned array is : water,orange,mango,banana,sugar
Length of the array is : 5