JavaScript Array toSpliced()

Definição e uso

toSpliced() O método é usado para adicionar e/ou remover elementos do array.

toSpliced() O método retorna um novo array.

toSpliced() O método não altera o array original.

toSpliced() O método é splice() Versão cópia do método.

Veja também:

Método splice() do Array

Método slice() do Array

Exemplo

Exemplo 1

// Cria um array
const fruits = ["Banana", "Orange", "Apple", "Mango"];
// Adiciona "Lemon" e "Kiwi" na posição 2
const fruits2 = fruits.toSpliced(2, 0, "Lemon", "Kiwi");

Experimente você mesmo

Exemplo 2

// Cria um array
const fruits = ["Banana", "Orange", "Apple", "Mango"];
// Remove 2 elementos na posição 2
const fruits2 = fruits.toSpliced(2, 2);

Experimente você mesmo

Exemplo 3

// Cria um array
const fruits = ["Banana", "Orange", "Apple", "Mango"];
// Remove 1 elemento na posição 2 e adiciona "Lemon" e "Kiwi"
const fruits2 = fruits.toSpliced(2, 1, "Lemon", "Kiwi");

Experimente você mesmo

Sintaxe

array.toSpliced(index, count, item1, ....., itemX)

Parâmetros

Parâmetros Descrição
index

Obrigatório. Índice (posição) do elemento a ser adicionado ou removido.

Valores negativos começam a contar do final do array.

count Opcional. Número de elementos a serem removidos.
item1,... Opcional. Novos elementos a serem adicionados.

Retorno

Tipo Descrição
Array Novo array com mudanças incluídas.

Suporte do navegador

toSpliced() É uma característica do ES2023.

A partir de julho de 2023, todos os navegadores modernos suportam este método:

Chrome Edge Firefox Safari Opera
Chrome 110 Edge 110 Firefox 115 Safari 16.4 Opera 96
Fevereiro de 2023 Fevereiro de 2023 Julho de 2023 Março de 2023 Maio de 2023