Resumo : neste tutorial, você aprenderá como usar o toSpliced()
método JavaScript Array para alterar o conteúdo de um array e retornar o novo array.
Introdução ao método JavaScript Array toSpliced()
O toSpliced()
método permite obter um novo array removendo e/ou substituindo elementos especificados em um determinado índice, deixando o array original intacto.
O toSpliced()
método, ao contrário do splice()
método, não altera o array original em vigor. Em vez disso, ele retorna um novo array contendo os elementos modificados, deixando o array original inalterado.
Aqui está a sintaxe do toSpliced()
método:
Array.prototype.toSpliced(start, deleteCount, element1, element2,... elementN)
Linguagem de código: JavaScript ( javascript )
Nesta sintaxe:
start
: Este é um índice baseado em zero a partir do qual começar a alterar a matriz.deleteCount
(opcional): Um número inteiro que indica o número de elementos para remover a matriz começando no início. SedeleteCount
for zero, o método não remove nenhum elemento. Nesse caso, você precisa especificar pelo menos um elemento após ele para adicionar ao array.element1
,element2
,…elementN
: Novos elementos para adicionar ao array começando do início. Se não, você não especifica nenhum elemento, o método apenas faz a remoção.
O toSpliced()
método retorna uma nova matriz compreendendo todos os elementos antes do início especificado, seguido por element1
, element2
,…, elementN
e todos os elementos depois de start + deleteCount
.
Exemplos de métodos JavaScript Array toSpliced()
Vamos explorar alguns exemplos de uso do toSpliced()
método.
1) Usando o método toSpliced() para remover elementos de um array
O exemplo abaixo demonstra o uso do toSpliced()
método para remover elementos de um array e gerar um novo array sem esses elementos:
const scores = [1,2,3,4,5];
const newScores = scores.toSpliced(0,2);
console.log(scores);
console.log(newScores);
Linguagem de código: JavaScript ( javascript )
Saída:
[ 1, 2, 3, 4, 5 ]
[ 3, 4, 5 ]
Linguagem de código: JavaScript ( javascript )
A saída confirma que o array original ( scores
) permanece inalterado, enquanto o array retornado ( newScores
) teve dois elementos removidos.
2) Usando o método toSpliced() para adicionar elementos a um array
O exemplo a seguir usa o toSpliced()
método para adicionar dois números ao início da scores
matriz:
const scores = [3,4,5];
const newScores = scores.toSpliced(0, 0, 1, 2);
console.log(scores);
console.log(newScores);
Linguagem de código: JavaScript ( javascript )
Saída:
[ 3, 4, 5 ]
[ 1, 2, 3, 4, 5 ]
Linguagem de código: JavaScript ( javascript )
Neste exemplo:
- O primeiro argumento 0 indica que o método começará a alterar o array na posição 0.
- O segundo argumento 0 instrui o método a não remover nenhum elemento.
- Os dois últimos argumentos 1 e 2 são o novo elemento que o método adiciona ao array
O método retorna um novo array newScores
com dois novos elementos 1 e 2 no início do array.
3) Usando toSpliced() para substituir elementos em um array
O exemplo a seguir usa o toSpliced()
método para substituir dois números no início da scores
matriz:
const scores = [0,0,3,4,5];
const newScores = scores.toSpliced(0, 2, 1, 2);
console.log(scores);
console.log(newScores);
Linguagem de código: JavaScript ( javascript )
Saída:
[ 0, 0, 3, 4, 5 ]
[ 1, 2, 3, 4, 5 ]
Linguagem de código: JavaScript ( javascript )
Neste exemplo:
- O primeiro argumento 0(
start
) indica que o método começará a alterar o array na posição 0. - O segundo argumento 2(
deleteCount
) instrui o método a remover dois elementos começando na posição 0. Em outras palavras, remove o primeiro e o segundo elementos doscores
array. - Os dois últimos argumentos são os novos elementos que o método adiciona ao array de pontuações na posição 0.
Resumo
- Use o método JavaScript Array
toSpliced()
para modificar os elementos de um array e obter o array atualizado como resultado.