JavaScript - Método Array splice ()

Descrição

Array Javascript splice() método muda o conteúdo de um array, adicionando novos elementos enquanto remove elementos antigos.

Sintaxe

Sua sintaxe é a seguinte -

array.splice(index, howMany, [element1][, ..., elementN]);

Detalhes de Parâmetro

  • index - Índice no qual começar a alterar a matriz.

  • howMany- Um inteiro indicando o número de elementos antigos da matriz a serem removidos. E sehowMany é 0, nenhum elemento é removido.

  • element1, ..., elementN- Os elementos a serem adicionados à matriz. Se você não especificar nenhum elemento, o splice simplesmente remove os elementos da matriz.

Valor de retorno

Retorna a matriz extraída com base nos parâmetros passados.

Exemplo

Experimente o seguinte exemplo.

<html>
   <head>
      <title>JavaScript Array splice Method</title>
   </head>
   
   <body>   
      <script type = "text/javascript">
         var arr = ["orange", "mango", "banana", "sugar", "tea"];         
         var removed = arr.splice(2, 0, "water");
         document.write("After adding 1: " + arr );
         document.write("<br />removed is: " + removed);
         
         removed = arr.splice(3, 1);
         document.write("<br />After adding 1: " + arr );
         document.write("<br />removed is: " + removed);
      </script>      
   </body>
</html>

Resultado

After adding 1: orange,mango,water,banana,sugar,tea
removed is: 
After adding 1: orange,mango,water,sugar,tea
removed is: banana