Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Location.href — odczyt adresu i nawigacja

Location.href udostępnia adres URL dokumentu jako tekst. Przypisanie wartości rozpoczyna nawigację, zamiast jedynie zmieniać zwykłą zmienną.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

window.location.href
window.location.href = url

Location.href to właściwość przeglądarkowego API, dostępna przez window.location.href. Odczyt zwraca zserializowany URL dokumentu, wraz z zapytaniem i fragmentem, jeśli występują.

Przypisanie window.location.href = url rozpoczyna nawigację. Przy przypisaniu adres względny jest rozwiązywany względem bazowego URL interfejsu API obiektu ustawień wejściowych (entry settings object). Przy synchronicznym wywołaniu między ramkami może to być bazowy URL ramki inicjującej wywołanie, a nie ramki, której kod wykonuje przypisanie. Niepoprawny adres może spowodować SyntaxError typu DOMException.

Odczyt adresu innego okna podlega ograniczeniom pochodzenia i może spowodować SecurityError. Przykład tylko odczytuje adres; nie opuszcza strony.

Przykłady

const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());

Wynik

string
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła