Obiekt Location

Obiekt Location

Obiekt Location zawiera informacje dotyczące aktualnego URL.

Obiekt Location jest częścią obiektu Window, który można uzyskać za pomocą atrybutu window.location.

Przykład

Przenieś użytkownika do nowego adresu

Atrybuty obiektu Location

Atrybuty Opis
hash Ustawia lub zwraca część URL (ankr) zaczynającą się od znaku hash (#).
host Ustawia lub zwraca nazwę hosta i port aktualnego URL.
hostname Ustawia lub zwraca nazwę hosta aktualnego URL.
href Ustawia lub zwraca pełny URL.
pathname Ustawia lub zwraca część ścieżki URL.
port Ustawia lub zwraca port aktualnego URL.
protocol Ustawia lub zwraca protokół aktualnego URL.
search Ustawia lub zwraca część URL (część zapytania) zaczynającą się od znaku zapytania (?).

Metody obiektu Location

Atrybuty Opis
assign() Załaduj nowy dokument.
reload() Ponownie załaduj aktualny dokument.
replace() Zastąp aktualny dokument nowym dokumentem.

Opis obiektu Location

Obiekt Location jest przechowywany w atrybucie Location obiektu Window, oznacza to adres Web aktualnie wyświetlanego dokumentu w oknie. Jego Atrybut hrefZawiera pełny URL dokumentu, inne atrybuty opisują poszczególne części URL. Te atrybuty są bardzo podobne do atrybutu URL obiektu Anchor (lub obiektu Area). Kiedy obiekt Location jest przekształcony w ciąg znaków, zwracana jest wartość atrybutu href. Oznacza to, że możesz 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 dokumentu wyświetlanego przez przeglądarkę. Jednak obiekt Location może zrobić więcej niż to, kontrolując pozycję dokumentu wyświetlanego przez przeglądarkę. Jeśli przypisze się do obiektu Location lub jego właściwości href ciąg znaków zawierający URL, przeglądarka załaduje i wyświetli dokument wskazywany przez nowy URL.

Oprócz zastąpienia bieżącego URL pełnym URL za pomocą location lub location.href, można również zmodyfikować część URL, wystarczy przypisać wartości innym właściwości obiektu Location. W ten sposób zostanie utworzony nowy URL, w którym część jest inna niż w oryginalnym URL. Przeglądarka załaduje i wyświetli go. Na przykład, jeśli 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 przeładuje URL z nową ciągłą wartością zapytania.

Oprócz właściwości URL, obiekt Location Metoda reload()Można ponownie załadować bieżący dokumentreplace() 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.