Array.prototype.shift()

El mètode shift() elimina el primer element d'un array i retorna l'element eliminat. Aquest mètode canvia el tamany de l'array.

Sintaxi

arr.shift()

Descripció

El mètode shift elimina l'element de l'array situat a la posició zero i mou la resta d'elements a la posició immediatament menor, tot seguit retorna el valor de l'element eliminat. Si la propietat length de l'array és 0, aquest mètode retornarà undefined.

shift és generic de forma intencionada; aquest mètode pot ser cridat o bé aplicat a objectes que es comportin com a arrays. Els objectes que no continguin una propietat length que reflecteixi l'última propietat numèrica poden tenir un comportament erràtic.

Exemples

Eliminar un element d'un array

El codi següent mostra l'array myFish abans i després d'eliminar el seu primer element. També mostra l'element eliminat:

var myFish = ['angel', 'clown', 'mandarin', 'surgeon'];

console.log('myFish abans: ' + myFish);
// "myFish abans: angel,clown,mandarin,surgeon"

var shifted = myFish.shift(); 

console.log('myFish després: ' + myFish); 
// "myFish després: clown,mandarin,surgeon" 

console.log('Element eliminat: ' + shifted); 
// "Element eliminat: angel"

Especificacions

Compatibilitat amb navegadors

Vegeu també

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