CKTIS / JavaScript
Array.prototype.unshift: dodajanje na začetek
unshift premakne obstoječe indekse v desno, vstavi argumente na začetek in vrne novo dolžino prejemnika.
Različica: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaksa
array.unshift(...items)array.unshift(...items) spremeni array: obstoječe indeksirane lastnosti premakne za število argumentov k višjim indeksom, zapiše items od indeksa nič in posodobi length. Vrne novo dolžino; argumenti ohranijo vrstni red, zato unshift("a", "b") postavi a pred b. Brez argumentov dolžina ostane enaka.
Luknje se med premikom ohranijo: manjkajoča izvorna lastnost povzroči izbris ustrezne ciljne lastnosti. Metoda je splošna za spremenljive array-like objekte in ne ustvari tabele rezultata.
Če bi nova dolžina presegla 2^53 - 1, sproži TypeError; navadni Array imajo dodatno omejitev. Nezapisljivi indeksi ali length, neizbrisljive lastnosti ter napake getterjev, setterjev ali proxy pasti lahko operacijo prekinejo po delnih spremembah. API obstaja od ECMAScript 1.
Primeri
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