O método splice() do Array JavaScript

Este tutorial mostra como usar o método splice() do Array para excluir elementos existentes, inserir novos elementos e substituir elementos em um array JavaScript.

English version: https://www.javascripttutorial.net/javascript-array-splice/

O tipo Array do JavaScript fornece um método splice() muito poderoso que permite inserir novos elementos no meio de um array. No entanto, você pode usar esse método para excluir e substituir elementos existentes também,

Deletando elementos usando splice()

Para deletar elementos em um array, você passa dois argumentos para o método spice() da seguinte forma:

O argumento position determina a posição do primeiro item a ser excluído e o argumento num determina o número de elementos a serem excluídos.

O método splice() altera o array original e retorna um array que contém os elementos excluídos.

Vamos dar uma olhada no exemplo a seguir.

Suponha que você tenha uma matriz que contenha cinco números de 1 a 5.

A instrução a seguir exclui três elementos do array scores começando no primeiro elemento e cria um novo array deletedScores que armazena os valores excluídos:

O array scores agora contém dois elementos.

E o array deletedScores contém 3 elementos:

A figura a seguir ilustra a chamada do método score.splice(0, 3):

Inserindo elementos usando splice()

Você pode inserir um ou mais elementos em uma matriz (em um array) passando 3 ou mais argumentos para o método splice() com o segundo argumento igual a zero.

Considere a seguinte sintaxe:

Compreenda essa sintaxe:

• O argumento position determina a posição inicial da matriz em que os novos elementos serão inseridos.
• O segundo argumento é zero 0 que dá o comando ao método splice() para não excluir nenhum elemento.
• O terceiro argumento, o quarto e assim por diante, são os valores dos novos elementos a serem inseridos no array.

Observe que o método splice() realmente altera o array original. Além disso, o método splice() não remove nenhum elemento nesse caso ele retorna um array vazio. Por exemplo:

Suponha que você tenha uma matriz (um array) chamada colors com 3 strings:

A instrução a seguir insere um elemento após o segundo elemento:

O array colors agora tem 4 elementos com o novo elemento inserido na segunda posição.

A figura a seguir ilustra a chamada do método acima:

Você pode inserir mais de um elemento, passando o quarto argumento, o quinto, e assim por diante. Veja o exemplo:

Substituindo elementos usando o splice()

O método splice() permite inserir novos elementos e excluir elementos existentes em um array simultaneamente.

Para fazer isso você passa pelo menos 3 argumentos, sendo o segundo que vai especificar o número de ítens a serem excluídos e o terceiro indicando os elementos a serem inseridos.

Observe que o número de elementos a serem excluídos não precisa ser o mesmo número de elementos a serem inseridos.

Suponha que você tenha um array de linguagens de programação com quatro elementos, como a seguir:

A instrução a seguir substitui o segundo elemento por um novo:

O array languages agora ainda tem 4 elementos com o novo segundo elemento sendo Python em vez de C++.

A figura a seguir ilustra a chamada de método acima.

Você pode substituir um elemento por vários elementos, passando mais argumentos para o método splice() da seguinte forma:

Códigos dos exemplos

Nesse tutorial você pode aprender como usar o método splice() do Array JavaScript para deletar elementos existentes, inserir novos elementos e substituir elementos em um array.

Veja o índice de todos os tutoriais JavaScript

Tutoriais JavaScript