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 July 2015.

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

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

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
unshift

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Ver también