Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.unshift: dodawanie na początku

unshift przesuwa istniejące indeksy w prawo, wstawia argumenty na początku i zwraca nową długość odbiorcy.

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

Składnia

array.unshift(...items)

array.unshift(...items) mutuje array: przesuwa istniejące własności indeksowe o liczbę argumentów w kierunku większych indeksów, zapisuje items od indeksu zero i aktualizuje length. Zwraca nową długość, a argumenty zachowują kolejność, więc unshift("a", "b") umieszcza a przed b. Bez argumentów długość pozostaje taka sama.

Dziury są zachowywane podczas przesuwania: brak źródłowej własności powoduje usunięcie odpowiadającej pozycji docelowej. Metoda jest generyczna dla mutowalnych obiektów array-like i nie tworzy tablicy wyniku.

Jeśli nowa długość przekroczyłaby 2^53 - 1, zgłaszany jest TypeError; zwykła tablica ma dodatkowo limit długości. Niezapisywalne indeksy lub length, nieusuwalne własności oraz błędy getterów, setterów i proxy trapów mogą przerwać operację po częściowych zmianach. API istnieje od ECMAScript 1.

Przykłady

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

Wynik

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

Źródła