El método unshift() agrega uno o más elementos al inicio del array, y devuelve la nueva longitud del array.

Sintaxis

arr.unshift(elemento1[, ...[, elementoN]])

Parámetros

elementoN
Elementos a agregar al inicio del array.

Devuelve

La nueva propiedad length del objeto sobre el cual el método fue llamado.

Descripción

El método unshift inserta los valores proporcionados al inicio de un objeto del tipo array.

unshift es intencionalmente genérico; este método puede ser called o applied a objetos similares a arrays. Objetos que no contengan una propiedad length reflejando una serie de propiedades numéricas consecutivas, comenzada a partir del cero, pueden no comportarse de una manera comprensible.

Ejemplos

var arr = [1, 2];

arr.unshift(0); // resultado de la llamada es 3, la nueva longitud del array
// arr es [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr es [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr es [[-3], -2, -1, 0, 1, 2]

Especificaciones

Especificación Status Comentario
ECMAScript 3rd Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
La definición de 'Array.prototype.unshift' en esta especificación.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La definición de 'Array.prototype.unshift' en esta especificación.
Standard  
ECMAScript Latest Draft (ECMA-262)
La definición de 'Array.prototype.unshift' en esta especificación.
Draft  

Compatibilidad en navegadores

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
Soporte básicoChrome Soporte completo 1Edge Soporte completo SiFirefox Soporte completo 1IE Soporte completo 5.5Opera Soporte completo SiSafari Soporte completo SiWebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo SiSafari iOS Soporte completo SiSamsung Internet Android Soporte completo Sinodejs Soporte completo Si

Leyenda

Soporte completo  
Soporte completo

Ver también

Etiquetas y colaboradores del documento

Colaboradores en esta página: AlePerez92, elhesuu
Última actualización por: AlePerez92,