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