CKTIS / JavaScript
Array.prototype.unshift: přidání na začátek
unshift posune existující indexy doprava, vloží argumenty na začátek a vrátí novou délku příjemce.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
array.unshift(...items)array.unshift(...items) změní array: existující indexované vlastnosti posune o počet argumentů k vyšším indexům, zapíše items od nuly a aktualizuje length. Vrátí novou délku; argumenty zachovají pořadí, takže unshift("a", "b") umístí a před b. Bez argumentů délka zůstane stejná.
Díry se při posunu zachovají: chybějící zdrojová vlastnost způsobí smazání odpovídající cílové vlastnosti. Metoda je obecná pro měnitelné array-like objekty a nevytváří výsledné pole.
Pokud by nová délka překročila 2^53 - 1, vyvolá TypeError; běžná Array mají další limit délky. Nezapisovatelné indexy či length, nesmazatelné vlastnosti a chyby getterů, setterů nebo proxy trapů mohou operaci přerušit po dílčích změnách. API existuje od ECMAScript 1.
Pří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ýsledek
4 lint,build,test,deploy 3 true false true a b 3 3 first false second