Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
Array.prototype.unshift()
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étodounshift() agrega uno o más elementos al inicio del array, y devuelve la nueva longitud del array.
In this article
Pruébalo
const array1 = [1, 2, 3];console.log(array1.unshift(4, 5));// Expected output: 5console.log(array1);// Expected output: Array [4, 5, 1, 2, 3]Sintaxis
arr.unshift(elemento1[, ...[, elementoN]])
Parámetros
elementoNElementos a agregar al inicio del array.
Devuelve
La nueva propiedadlength del objeto sobre el cual el método fue llamado.
Descripción
El métodounshift inserta los valores proporcionados al inicio de un objeto del tipo array.
unshift es intencionalmente genérico; este método puede sercalled oapplied a objetos similares a arrays. Objetos que no contengan una propiedadlength 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-array.prototype.unshift> |