[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/unshift [Back]  [Original]

Array.prototype.unshift() - JavaScript | MDN

Esta pgina ha sido traducida del ingls por la comunidad. Aprende ms 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. Its been available across browsers since julio de 2015.

El mtodo unshift() agrega uno o ms elementos al inicio del array, y devuelve la nueva longitud del array.

In this article

Prubalo

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]])

Parmetros

elementoN

Elementos a agregar al inicio del array.

Devuelve

La nueva propiedad length del objeto sobre el cual el mtodo fue llamado.

Descripcin

El mtodo unshift inserta los valores proporcionados al inicio de un objeto del tipo array.

unshift es intencionalmente genrico; este mtodo puede ser called o applied a objetos similares a arrays. Objetos que no contengan una propiedad length reflejando una serie de propiedades numricas 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 LanguageSpecification
# sec-array.prototype.unshift

Compatibilidad con navegadores

Ver tambin


Web Proxy Viewer  |  New URL  |  Original Page