HOWTO · JavaScript

Remover o primeiro elemento de um array em JavaScript

Este artigo explica diferentes maneiras de remover o primeiro elemento de um array JavaScript.

Nesta página

Para remover o primeiro elemento de um array JavaScript, use shift() ou splice(0, 1) para alterar o array original. Se precisar preservá-lo, use slice(1) ou filter() para criar um novo array. shift() retorna o elemento removido como um valor único, enquanto splice(0, 1) o retorna dentro de um array.

Remover o primeiro elemento alterando o array original

Tanto shift() quanto splice() removem um elemento do array original. Escolha shift() quando quiser sempre remover o primeiro elemento; escolha splice() quando precisar aplicar a mesma operação em um índice específico ou remover vários elementos.

shift() remove o elemento do índice 0, desloca os elementos restantes para o início e retorna o valor removido. Execute este exemplo para ver o array atualizado e o elemento retornado:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const items = ["first", "second", "third"];
const removed = items.shift();
console.log(JSON.stringify({ items, removed }));
{"items":["second","third"],"removed":"first"}

Depois dessas instruções, items contém as duas últimas strings, e removed contém "first". Em um ambiente JavaScript, JSON.stringify() transforma o objeto impresso em uma única linha JSON.

Use splice(start, deleteCount) quando precisar escolher a posição. Para remover o primeiro elemento, passe 0 como start e 1 como deleteCount. O array original é alterado, e o método retorna um array com os elementos removidos. Por exemplo, com const values = ["red", "green", "blue"], const removed = values.splice(0, 1) deixa values como ["green", "blue"] e define removed como ["red"].

O argumento start indica um índice; ele não define uma direção de deslocamento. Um índice não negativo conta a partir do início, enquanto um índice negativo conta de trás para frente, a partir do fim (-1 se refere ao último elemento). deleteCount especifica quantos elementos remover a partir dessa posição. Se você omitir esse argumento, splice() remove todos os elementos a partir de start. Os elementos informados depois de deleteCount são inseridos nessa posição. Para conhecer todos os parâmetros do método, consulte a referência de splice() no MDN.

Remover o primeiro elemento sem alterar o array original

slice() e filter() retornam novos arrays e mantêm o array de entrada inalterado. Use slice(1) para copiar diretamente todos os elementos depois do primeiro. O índice start é incluído, e o índice end opcional é excluído. Assim, values.slice(1) copia os elementos do índice 1 até o fim; não remove nada de values. Consulte o guia de slice() e a referência de slice() no MDN para saber mais. O guia vinculado está disponível em inglês.

Use filter() quando a remoção depender de uma condição. A função de callback é executada para cada elemento, e aqueles para os quais ela retorna true são incluídos em um novo array. Para ignorar apenas a primeira posição, filtre pelo índice:

const remaining = values.filter((item, index) => index > 0);

Isso mantém os elementos seguintes na ordem atual e preserva values. Filtrar pelo índice expressa uma regra posicional; se o array já tiver sido reordenado, a operação ainda excluirá o elemento na posição 0, qualquer que seja seu valor.

Por exemplo, com const values = ["red", "green", "blue"], tanto values.slice(1) quanto values.filter((item, index) => index > 0) produzem um novo array com ["green", "blue"], enquanto values permanece como ["red", "green", "blue"].

Escolha o método adequado ao que você precisa fazer com o array

  • Use shift() quando o array original deve ser alterado e você precisa do elemento removido como um valor único.
  • Use splice(0, 1) quando o array original deve ser alterado e for útil receber os elementos removidos em um array; para remover elementos de outra posição, ajuste o índice e a quantidade.
  • Use slice(1) quando quiser um novo array com todos os elementos depois do primeiro.
  • Use filter() quando os elementos mantidos forem definidos por uma condição; uma condição baseada no índice basta para ignorar a primeira posição.

A escolha principal é saber se outro trecho do código ainda precisa do array original. Os métodos que alteram o array modificam esse objeto compartilhado, então todas as referências a ele refletem a mudança. Os métodos que não o alteram mantêm o array disponível e retornam um resultado separado. Os quatro métodos preservam a ordem relativa dos elementos mantidos.