Obiekt Window Location

Obiekt Window Location

Obiekt Location zawiera informacje dotyczące bieżącej URL.

Obiekt Location jest właściwością obiektu okna.

Obiekt Location można uzyskać w następujący sposób:

window.location lub tylko location

Przykład

let origin = window.location.origin;

Spróbuj sam!

let origin = location.origin;

Spróbuj sam!

Właściwości obiektu Location

Właściwości Opis
hash Ustawiać lub zwracać część kotwicy URL (#).
host Ustawiać lub zwracać nazwę hosta i port URL.
hostname Ustawiać lub zwracać nazwę hosta URL.
href Ustawiać lub zwracać cały URL.
origin Zwracać protokół, nazwę hosta i port URL.
pathname Ustawiać lub zwracać nazwę ścieżki URL.
port Ustawiać lub zwracać port URL.
protocol Ustawiać lub zwracać protokół URL.
search Ustawiać lub zwracać część zapytania URL.

Metody obiektu Location

Metoda Opis
assign() Załadować nowy dokument.
reload() Ponownie załadować bieżący dokument.
replace() Zastąpić bieżący dokument nowym dokumentem.

Opis obiektu Location

Obiekt Location jest przechowywany w właściwości Location obiektu Window i reprezentuje adres Web bieżącego wyświetlanego dokumentu w oknie. Jego właściwość hrefZawiera pełny URL dokumentu, inne właściwości opisują różne części URL. Te właściwości są bardzo podobne do właściwości URL obiektu Anchor (lub obiektu Area). Kiedy obiekt Location jest przekształcany w ciąg, zwracana jest wartość właściwości href. Oznacza to, że można używać wyrażenia location zamiast location.href.

Jednak obiekt Anchor reprezentuje hiperłącze w dokumencie, podczas gdy obiekt Location reprezentuje URL (lub pozycję) bieżącego wyświetlanego dokumentu przeglądarki. Jednak możliwości obiektu Location są znacznie szersze, ponieważ może on kontrolować pozycję wyświetlanego dokumentu. Jeśli przypiszemy ciąg zawierający URL do obiektu Location lub jego właściwości href, przeglądarka załaduje i wyświetli dokument wskazywany przez nowy URL.

Poza ustawieniem location lub location.href na pełny URL, można również zmodyfikować część URL, wystarczy przypisać inne wartości do właściwości obiektu Location. W ten sposób utworzy się nowy URL, w którym część różni się od oryginalnego URL, przeglądarka załaduje go i wyświetli. Na przykład, zakładając, że ustawiono właściwość hashWtedy przeglądarka przejdzie do określonej pozycji w bieżącym dokumencie. Podobnie, jeśli ustawiono właściwość searchWtedy przeglądarka ponownie załaduje URL z dodatkowym zapytaniem.

Oprócz atrybutu URL, obiekt Location zawiera również inne atrybuty. Metoda reload()Można ponownie załadować bieżący dokument,replace() Można załadować nowy dokument bez konieczności tworzenia nowej historii, co oznacza, że nowy dokument zastąpi bieżący dokument w liście historii przeglądarki.