CKTIS / JavaScript
Array.prototype.unshift: dodavanje na početak
unshift pomiče postojeće indekse udesno, umeće argumente na početak i vraća novu duljinu primatelja.
Verzija: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaksa
array.unshift(...items)array.unshift(...items) mijenja array: postojeća indeksirana svojstva pomiče za broj argumenata prema većim indeksima, zapisuje items od indeksa nula i ažurira length. Vraća novu duljinu; argumenti zadržavaju redoslijed, pa unshift("a", "b") stavlja a prije b. Bez argumenata duljina ostaje ista.
Rupe se pri pomicanju čuvaju: nepostojeće izvorno svojstvo uzrokuje brisanje odgovarajućeg ciljnog svojstva. Metoda je generička za promjenjive array-like objekte i ne stvara polje rezultata.
Ako bi nova duljina prešla 2^53 - 1, baca TypeError; obični Array imaju dodatno ograničenje. Nezapisivi indeksi ili length, neizbrisiva svojstva te pogreške gettera, settera ili proxy zamki mogu prekinuti operaciju nakon djelomičnih promjena. API postoji od ECMAScript 1.
Primjeri
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]);Rezultat
4 lint,build,test,deploy 3 true false true a b 3 3 first false second