Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Składowe adresu strony: origin, pathname, search, hash i href

Obiekt window.location udostępnia cały adres bieżącej strony oraz jego części. Poznaj różnice między origin, pathname, search, hash i href oraz powód, dla którego zapis do Location może uruchomić nawigację.

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.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location to obiekt Location powiązany z bieżącym dokumentem; jest dostępny również jako document.location. Jego właściwości opisują adres strony i zwracają ciągi znaków. To przeglądarkowe Web API, a nie funkcja samego ECMAScript. Obecność Node 24 w repozytorium nie potwierdza obsługi przeglądarkowego Location.

Location.origin jest tylko do odczytu. Dla HTTP(S) zawiera schemat, //, nazwę hosta i port, jeśli nie jest domyślny; nie zawiera ścieżki. Dla file: wynik zależy od przeglądarki, więc nie należy uogólniać reguł HTTP(S) na wszystkie schematy. Location.pathname zawiera ścieżkę bez zapytania i fragmentu; dla HTTP(S) zaczyna się od /.

Location.search zwraca niepuste zapytanie z początkowym znakiem ?. Jeśli zapytania nie ma lub jest puste, zwraca "", także wtedy, gdy adres kończy się samym znakiem ?. Odczyt nie dekoduje sekwencji procentowych: %20 pozostaje %20. Do odczytu poszczególnych parametrów użyj new URLSearchParams(window.location.search). Location.hash zwraca niepusty fragment z początkowym znakiem #. Jeśli fragmentu nie ma lub jest pusty, zwraca "", także wtedy, gdy adres kończy się samym znakiem #. Location.href zwraca cały adres, łącznie z zapytaniem i fragmentem.

Odczyt tych właściwości nie zmienia strony, ale zapis do href uruchamia nawigację. Zmiana pathname lub search także może załadować dokument; zmiana samego hash zwykle oznacza nawigację w obrębie dokumentu. Do bezpiecznego analizowania dowolnego adresu użyj URL, zamiast modyfikować window.location. Przykład wykorzystuje osobny obiekt URL z analogicznymi nazwami właściwości: wynik jest stały i strona nie zostaje przekierowana. Nie jest to test działania nawigacji Location.

Przykłady

const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
  console.log(`${key}: ${url[key]}`);
}

Wynik

origin: https://example.org:8443
pathname: /docs/start
search: ?q=web%20api
hash: #intro
href: https://example.org:8443/docs/start?q=web%20api#intro

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

Źródła