El método shift() elimina el primer elemento del array y devuelve dicho elemento. Este método modifica la longitud del array.

Sintaxis

arr.shift()

Descripción

El método shift elimina el elemento en el índice cero y desplaza los valores consecutivos hacia abajo, devolviendo el valor eliminado. Si la propiedad length es 0, devuelve undefined.

shift es genérico; este método puede utilizarse con callapply a objetos simliares a arrays. Los objetos que no tengan una propiedad length que refleje el último elemento de una serie consecutiva de propiedades numéricas con índice base cero pueden no comportarse de manera significativa.

Ejemplos

Eliminando un elemento de un array

El siguiente código muestra el contenido del array miPescado antes y después de eliminar el primer elemento. También muestra el elemento eliminado:

var miPescado = ['ángel', 'payaso', 'mandarín', 'cirujano'];

console.log('miPescado antes: ' + miPescado);
// "miPescado antes: ángel,payaso,mandarín,cirujano"

var eliminado = miPescado.shift(); 

console.log('miPescado después: ' + miPescado); 
// "miPescado after: payaso,mandarín,cirujano" 

console.log('Elemento eliminado: ' + eliminado); 
// "Elemento eliminado: ángel"

Especificaciones

Specification Status Comment
ECMAScript 3rd Edition (ECMA-262) Standard Definición inicial. Implementado en Javascript 1.2.
ECMAScript 5.1 (ECMA-262)
La definición de 'Array.prototype.shift' en esta especificación.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La definición de 'Array.prototype.shift' en esta especificación.
Standard  

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte básico 1.0 1.0 (1.7 o anterior) 5.5 (Yes) (Yes)
Característica Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Ver también

Etiquetas y colaboradores del documento

Colaboradores en esta página: DsEsteban, gfernandez
Última actualización por: DsEsteban,