Matriz JavaScript para emendada – Acervo Lima Tutorials

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. Se deleteCountfor 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,…, elementNe 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 scoresmatriz:

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 newScorescom 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 scoresmatriz:

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 do scoresarray.
Os dois últimos argumentos são os novos elementos que o método adiciona ao array de pontuações na posição 0.