← 返回首页
Array.prototype.unshift() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Tecnología web para desarrolladores
  2. JavaScript
  3. Referencia de JavaScript
  4. Objetos globales
  5. Array
  6. Array.prototype.unshift()
Theme
  • OS default
  • Light
  • Dark
Español
Remember language Learn more

Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

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étodo unshift() 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: 5 console.log(array1); // Expected output: Array [4, 5, 1, 2, 3]

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

js
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® 2027 Language Specification
# sec-array.prototype.unshift

Compatibilidad con navegadores

Enable JavaScript to view this browser compatibility table.

Ver también

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 11 feb 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos globales
  2. Array
  3. Constructor
    1. Array() constructor
  4. Métodos estáticos
    1. Array.from()
    2. fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. Propiedades estáticas
    1. get Array[@@species]
  6. Métodos de instancia
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. toReversed()
    33. Array.prototype.toSorted()
    34. toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. with()
    39. Array.prototype[@@iterator]()
  7. Propiedades de instancia
    1. Array.prototype.length
    2. Array.prototype[@@unscopables]
  8. Herencia
  9. Object/Function
  10. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  11. Propiedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.prototype.arguments
    6. Function.caller
  12. Métodos de instancia
    1. Object.prototype.__defineGetter__()
    2. __defineSetter__()
    3. __lookupGetter__()
    4. __lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. Propiedades de instancia
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.