Baseline Widely available
ResumoO método splice() altera o conteúdo de uma lista, adicionando novos elementos enquanto remove elementos antigos.
Experimenteconst months = ["Jan", "March", "April", "June"];
months.splice(1, 0, "Feb");
// Inserts at index 1
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "June"]
months.splice(4, 1, "May");
// Replaces 1 element at index 4
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "May"]
Sintaxe
array.splice(indice[, deleteCount[, elemento1[, ...[, elementoN]]]) array.splice(indice) // SpiderMonkey/Firefox extensionParâmetros
indice
Ãndice o qual deve iniciar a alterar a lista. Se maior que o tamanho total da mesma, nenhum elemento será alterado. Se negativo, irá iniciar a partir daquele número de elementos a partir do fim.
deleteCount
Um inteiro indicando o número de antigos elementos que devem ser removidos.
Se o parâmetro deleteCount
não é especificado, ou se é maior que o número de elementos restantes na lista iniciando pelo Ãndice, então todos os elementos até o fim da lista serão deletados.
Se deleteCount
é 0, nenhum elemento é removido. Neste caso você deve especificar pelo menos um novo elemento.
elemento1, ..., elementoN
Os elementos a adicionar na lista. Se você não especificar nenhum elemento, splice simplesmente removerá elementos da mesma.
Uma lista contendo os elementos removidos. Se apenas um elemento é removido, por exemplo, uma lista contendo apenas um elemento é retornada. Se nenhum elemento é removido, uma lista vazia é retornada.
DescriçãoSe você especificar um número diferente de elementos a inserir comparado ao número de elementos que você está removendo, a lista terá um tamanho diferente no final da execução.
Exemplo Exemplo: Removendo 0 elementos do indice 2, e inserindo "drum"O script a seguir ilustra o uso do splice:
var myFish = ["angel", "clown", "mandarin", "surgeon"];
//remove 0 elementos a partir do Ãndice 2, e insere "drum"
var removed = myFish.splice(2, 0, "drum");
//myFish é ["angel", "clown", "drum", "mandarin", "surgeon"]
//removed é [], nenhum elemento removido
//remove 1 elemento do Ãndice 3
removed = myFish.splice(3, 1);
//myFish é ["angel", "clown", "drum", "surgeon"]
//removed é ["mandarim"]
//remove 1 elemento a partir do Ãndice 2, e insere "trumpet"
removed = myFish.splice(2, 1, "trumpet");
//myFish é ["angel", "clown", "trumpet", "surgeon"]
//removed é ["drum"]
//remove 2 elementos a partir do Ãndice 0, e insere "parrot", "anemone" e "blue"
removed = myFish.splice(0, 2, "parrot", "anemone", "blue");
//myFish é ["parrot", "anemone", "blue", "trumpet", "surgeon"]
//removed é ["angel", "clown"]
//remove 2 elementos a partir do indice 3
removed = myFish.splice(3, Number.MAX_VALUE);
//myFish é ["parrot", "anemone", "blue"]
//removed é ["trumpet", "surgeon"]
Especificações Compatibilidade com navegadores Veja Também
push
/ pop
- adiciona/remove elementos do final do array;unshift
/ shift
- adiciona/remove elementos do inÃcio do array;concat
- returns a new array comprised of this array joined with other array(s) and/or value(s).RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4