JavaScriptTablice

Array.prototype.unshift()

Dodaje elementy na początek tablicy i zwraca jej nową długość.

Zwraca
Nową długość tablicy.
Zmienia oryginał
Tak
Na tej stronie

Przykład

#
JavaScript
const notifications = ['Nowe zadanie']
notifications.unshift('Odznaka zdobyta', 'Seria 7 dni')

console.log(notifications)
Konsola
['Odznaka zdobyta', 'Seria 7 dni', 'Nowe zadanie']

Definicja i zastosowanie

#

Metoda unshift() wstawia jeden lub więcej elementów na początek tablicy, przesuwając istniejące elementy dalej. Zwraca nową długość tablicy.

Elementy przekazane w jednym wywołaniu zachowują swoją kolejność: unshift("a", "b") da tablicę zaczynającą się od "a", a potem "b".

Metoda zmienia oryginał. Wersja bez mutacji to [newItem, ...items], często używana w stanie aplikacji, na przykład przy dodawaniu najnowszego powiadomienia na górę listy.

Składnia

#
Składnia
array.unshift(element1, element2, …)

Parametry

#
  • element1…elementN

    dowolne wartości

    Elementy do wstawienia na początek.

Obsługa przeglądarek

#

Szeroko dostępne

Działa we wszystkich nowoczesnych przeglądarkach, także na telefonach. Możesz używać bez obaw.

  • Chrome
  • Edge
  • Firefox
  • Safari

Dobre praktyki

#
  • Wersja bez mutacji: [newItem, ...items].
  • Przy bardzo dużych tablicach częste unshift() jest wolne, bo przesuwa wszystkie elementy.

Powiązane hasła

#

Widzisz błąd albo brakuje przykładu? Napisz do nas.