База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.unshift: добавяне в началото

unshift измества съществуващите индекси надясно, вмъква аргументите отпред и връща новата дължина на получателя.

Версия: ECMAScript 1 onward; example target: Node.js 24.22.2

Синтаксис

array.unshift(...items)

array.unshift(...items) променя array: измества съществуващите индексирани свойства с броя аргументи към по-големи индекси, записва items от индекс нула и обновява length. Връща новата дължина; аргументите пазят реда си, затова unshift("a", "b") поставя a пред b. Без аргументи дължината остава същата.

Дупките се запазват при изместването: липсващо изходно свойство води до изтриване на съответното целево свойство. Методът е общ за променяеми array-like обекти и не създава масив резултат.

Ако новата дължина би надхвърлила 2^53 - 1, хвърля TypeError; обикновените Array имат допълнителен лимит. Незаписваеми индекси или length, неизтриваеми свойства и грешки от getter, setter или proxy trap могат да прекъснат операцията след частични промени. API съществува от ECMAScript 1.

Примери

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

Резултат

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

Източници