Array.prototype.unshift()
Baseline
Ampliamente disponible
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 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
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 |
|---|
| ECMAScript® 2027 Language Specification # sec-array.prototype.unshift |