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 = urlLocation.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.