← 返回首页
Array.prototype.splice() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Tecnologia Web para desenvolvedores
  2. JavaScript
  3. Referência JavaScript
  4. Objetos Globais
  5. Array
  6. Array.prototype.splice()
Theme
  • OS default
  • Light
  • Dark
Português (do Brasil)
Remember language Learn more

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Array.prototype.splice()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.

Resumo

O método splice() altera o conteúdo de uma lista, adicionando novos elementos enquanto remove elementos antigos.

In this article

Experimente

const 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 extension

Parâ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.

Retorno

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ção

Se 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:

js
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

Specification
ECMAScript® 2027 Language Specification
# sec-array.prototype.splice

Compatibilidade com navegadores

Enable JavaScript to view this browser compatibility table.

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).

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 24 de jun. de 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos Globais
  2. Array
  3. Construtor
    1. Array()
  4. Métodos estáticos
    1. Array.from()
    2. fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. Propriedades estáticas
    1. [Symbol.species]
  6. Métodos de instância
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. toReversed()
    33. toSorted()
    34. toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. with()
    39. Array.prototype[@@iterator]()
  7. Propriedades de instância
    1. Array.prototype.length
    2. Array.prototype[@@unscopables]
  8. Herança
  9. Object/Function
  10. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  11. Propriedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  12. Métodos de instância
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. Propriedades de instância
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.