Array.prototype.shift()

Experimente

const array1 = [1, 2, 3];

const firstElement = array1.shift();

console.log(array1);
// Expected output: Array [2, 3]

console.log(firstElement);
// Expected output: 1

Sintaxe

arr.shift()

Valor de retorno

O elemento removido do array; undefined se o array estiver vazio.

Descrio

O mtodo shift remove o elemento de ndice zero, diminui em 1 os indices dos demais valores e retorna o valor removido. Se a propriedade length for 0, ento undefined retornado.

shift intencionalmente genrico; esse mtodo pode ser chamado ou aplicado para objetos parecidos com arrays. Objetos que no contm a propriedade length representando o tamanho de uma srie consecutiva, comeando em zero, podem no se comportar de maneira correta.

Exemplos

Removendo um elemento de array

O cdigo a seguir mostra o array minhaLista antes e depois de remover seu primeiro elemento. Ele tambm mostra o elemento removido.

var minhaLista = ["anjo", "casa", "mandarim", "medico"];

console.log("minhaLista antes: " + minhaLista);
// minhaList antes: ['anjo', 'casa', 'mandarim', 'medico']
var shifted = minhaLista.shift();

console.log("minhaLista depois: " + minhaLista);
// minhaList depois: ['casa', 'mandarim', 'medico']
console.log("Elemento removido: " + shifted);
// Elemento removido: anjo

Usando o mtodo shift() dentro de um loop de while

O mdodo shift() frequentemente usado como condio dentro de um loop de while. No exemplo a seguir, cada iterao remover o elemento seguinte do array, at que ele esteja vazio:

var nomes = ["Andr", "Eduardo", "Paulo", "Cris", "Joo"];
while ((i = nomes.shift()) !== undefined) {
  console.log(i);
}
// Andr Eduardo Paulo Cris Joo

Especificaes

Compatibilidade de Browser

Veja tambm

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.unshift()
• Array.prototype.concat()