JavaScript Array toSpliced()
- Página anterior toSorted()
- Próxima página toString()
- Voltar à camada superior Manual de Referência JavaScript Array
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:
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");
Exemplo 2
// Cria um array const fruits = ["Banana", "Orange", "Apple", "Mango"]; // Remove 2 elementos na posição 2 const fruits2 = fruits.toSpliced(2, 2);
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");
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 |
- Página anterior toSorted()
- Próxima página toString()
- Voltar à camada superior Manual de Referência JavaScript Array