Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.unshift: añadir al principio

unshift desplaza los índices existentes a la derecha, inserta sus argumentos al principio y devuelve la nueva longitud del receptor.

Versión: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxis

array.unshift(...items)

array.unshift(...items) muta array: desplaza las propiedades indexadas hacia índices mayores según el número de argumentos, escribe items desde el índice cero y actualiza length. Devuelve la longitud nueva; los argumentos conservan su orden, de modo que unshift("a", "b") coloca a antes de b. Sin argumentos, la longitud no cambia.

Los huecos se conservan durante el desplazamiento: una propiedad de origen ausente hace que se elimine la propiedad de destino correspondiente. El método es genérico para objetos array-like mutables y no crea un array de resultado.

Si la nueva longitud superara 2^53 - 1, lanza TypeError; los Arrays ordinarios tienen otro límite de longitud. Índices o length no escribibles, propiedades no eliminables y fallos de getters, setters o traps de proxy pueden interrumpir la operación después de cambios parciales. La API existe desde ECMAScript 1.

Ejemplos

const queue = ["test", "deploy"];
const length = queue.unshift("lint", "build");
console.log(length, queue.join(","));

const sparse = [, "b"];
const sparseLength = sparse.unshift("a");
console.log(sparseLength, 0 in sparse, 1 in sparse, 2 in sparse, sparse[0], sparse[2]);

const arrayLike = { 1: "second", length: 2 };
const result = Array.prototype.unshift.call(arrayLike, "first");
console.log(result, arrayLike.length, arrayLike[0], 1 in arrayLike, arrayLike[2]);

Resultado

4 lint,build,test,deploy
3 true false true a b
3 3 first false second

Fuentes