Array.prototype.shift()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
El método shift() elimina el primer elemento del array y lo retorna. 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 call o apply 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 |
|---|
| ECMAScript® 2027 Language Specification # sec-array.prototype.shift |