Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri