Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.splice: remover, substituir e inserir

splice altera um array na posição escolhida, desloca a sua cauda e devolve um novo array com os elementos removidos.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.splice(start, deleteCount?, ...items)

array.splice(start, deleteCount?, ...items) altera array no próprio objeto e devolve um novo array com os elementos removidos. start é convertido em inteiro: um valor negativo conta desde o fim e uma posição além do comprimento significa o fim. Se start for fornecido mas deleteCount omitido, remove toda a cauda; passar undefined explicitamente significa zero. Outros valores são limitados entre zero e os elementos restantes. items são inseridos antes da cauda deslocada.

O comprimento do resultado é igual ao número de posições removidas e os espaços vazios correspondentes continuam vazios. O recetor pode crescer, diminuir ou manter o comprimento; splice() sem argumentos não remove nada. Em subclasses de Array, a criação do resultado respeita Symbol.species.

O método é genérico para objetos array-like mutáveis: lê length, copia ou elimina propriedades indexadas e escreve o novo comprimento. Pode lançar TypeError quando escrita, eliminação ou length são proibidas, ou se o novo comprimento excedesse 2^53 - 1; propagam-se erros de conversão, acessores, traps de proxy e construtor species.

Exemplos

const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));

const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));

const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));

const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));

Resultado

test
build,lint,test,deploy
test,deploy
build,lint
0 build,docs,lint
2 false true b c

Fontes