Array.prototype.shift()

Sumário

O método shift()remove o primeiro elemento de um array e retorna esse elemento. Este método muda o tamanho do array. 

Sintaxe

arr.shift()

Descrição

O método shift remove o elemento de índice zero, diminuí em 1 os indices dos demais valores e retorna o valor removido. Se a propriedade length for 0, então undefined é retornado.

shift é intencionalmente genérico; esse método pode ser chamado ou aplicado para objetos parecidos com arrays. Objetos que não contém a propriedade length representando o tamanho de uma série consecutiva, começando em zero, podem não se comportar de maneira correta.

Exemplos

Removendo um elemento de array

O código a seguir mostra o array minhaLista antes e depois de remover seu primeiro elemento. Ele também mostra o elemento removido.

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

console.log('minhaLista antes: ' + minhaLista);

var shifted = minhaLista.shift();

console.log('minhaLista depois: ' + minhaLista);
console.log('Elemento removido: ' + shifted);

O exemplo mostra o seguinte:

minhaLista antes: ['anjo','casa','mandarim','medico']
minhaLista depois: ['casa','mandarim','medico']

Elemento removido: anjo

Especificações

Compatibilidade de Browser

Veja também

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