Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Array.prototype.unshift: pridanie na začiatok

unshift posunie existujúce indexy doprava, vloží argumenty na začiatok a vráti novú dĺžku prijímateľa.

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

Syntax

array.unshift(...items)

array.unshift(...items) zmení array: existujúce indexované vlastnosti posunie o počet argumentov k vyšším indexom, zapíše items od nuly a aktualizuje length. Vráti novú dĺžku; argumenty zachovajú poradie, takže unshift("a", "b") umiestni a pred b. Bez argumentov dĺžka zostane rovnaká.

Diery sa pri posune zachovajú: chýbajúca zdrojová vlastnosť spôsobí zmazanie zodpovedajúcej cieľovej vlastnosti. Metóda je všeobecná pre meniteľné array-like objekty a nevytvára výsledné pole.

Ak by nová dĺžka presiahla 2^53 - 1, vyvolá TypeError; bežné Array majú ďalší limit dĺžky. Nezapisovateľné indexy či length, nezmazateľné vlastnosti a chyby getterov, setterov alebo proxy trapov môžu operáciu prerušiť po čiastočných zmenách. API existuje od ECMAScript 1.

Príklady

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

Výsledok

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

Zdroje