Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.unshift: aggiungere all’inizio

unshift sposta a destra gli indici esistenti, inserisce gli argomenti all’inizio e restituisce la nuova lunghezza del ricevente.

Versione: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintassi

array.unshift(...items)

array.unshift(...items) modifica array: sposta le proprietà indicizzate verso indici maggiori del numero di argomenti, scrive items dall’indice zero e aggiorna length. Restituisce la nuova lunghezza; gli argomenti mantengono l’ordine, quindi unshift("a", "b") pone a prima di b. Senza argomenti la lunghezza resta invariata.

I vuoti sono preservati durante lo spostamento: una proprietà sorgente assente fa eliminare la corrispondente proprietà di destinazione. Il metodo è generico per oggetti array-like mutabili e non crea un array risultato.

Se la nuova lunghezza superasse 2^53 - 1, genera TypeError; gli Array ordinari hanno un ulteriore limite. Indici o length non scrivibili, proprietà non eliminabili ed errori di getter, setter o trap di proxy possono interrompere l’operazione dopo modifiche parziali. L’API risale a ECMAScript 1.

Esempi

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

Risultato

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

Fonti