los unshift() El método agrega uno o más elementos al comienzo de un array y devuelve la nueva longitud de la array.

Sintaxis

unshift(element0)unshift(element0, element1)unshift(element0, element1,..., elementN)

Parámetros

elementN
Los elementos a añadir al frente de la arr.

Valor devuelto

El nuevo length propiedad del objeto sobre el que se llamó al método.

Descripción

los unshift El método inserta los valores dados al comienzo de un array-como objeto.

unshift es intencionalmente genérico. Este método se puede llamar o aplicar a objetos que se asemejan a matrices. Objetos que no contienen length La propiedad, que refleja la última de una serie de propiedades numéricas consecutivas basadas en cero, puede no comportarse de manera significativa.

Tenga en cuenta que, si se pasan varios elementos como parámetros, se insertan en fragmentos al principio del objeto, exactamente en el mismo orden en que se pasaron como parámetros. Por lo tanto, llamar unshift con n argumentos una vezo llamándolo n veces con 1 argumento (con un bucle, por ejemplo), no dan los mismos resultados.

Ver ejemplo:

let arr =[4,5,6]

arr.unshift(1,2,3)
console.log(arr);// [1, 2, 3, 4, 5, 6]

arr =[4,5,6]// resetting the array

arr.unshift(1)
arr.unshift(2)
arr.unshift(3)

console.log(arr)// [3, 2, 1, 4, 5, 6]

Ejemplos

usando unshift

let arr =[1,2]

arr.unshift(0)// result of the call is 3, which is the new array length// arr is [0, 1, 2]

arr.unshift(-2,-1)// the new array length is 5// arr is [-2, -1, 0, 1, 2]

arr.unshift([-4,-3])// the new array length is 6// arr is [[-4, -3], -2, -1, 0, 1, 2]

arr.unshift([-7,-6],[-5])// the new array length is 8// arr is [ [-7, -6], [-5], [-4, -3], -2, -1, 0, 1, 2 ]

Especificaciones

Especificación
Especificación del lenguaje ECMAScript (ECMAScript)
#segundo-array.prototipo.unshift

Compatibilidad del navegador

Escritorio Móvil
Cromo Borde Firefox explorador de Internet Ópera Safari WebView Android cromo androide Firefox para Android Ópera Android Safari en IOS Samsung Internet
unshift 1 12 1 5.5 4 1 1 18 4 10.1 1 1.0

Ver también

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