Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Součásti URL stránky: origin, pathname, search, hash a href

Objekt window.location zpřístupňuje úplnou URL aktuální stránky i její součásti. Poznejte rozdíly mezi origin, pathname, search, hash a href a zjistěte, proč zápis do Location může spustit navigaci.

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

Syntaxe

window.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location je objekt Location spojený s aktuálním dokumentem; přístupný je také jako document.location. Jeho vlastnosti popisují URL stránky a vracejí řetězce. Jde o webové API prohlížeče, nikoli o funkci samotného ECMAScriptu. Přítomnost Node 24 v repozitáři nedokládá podporu prohlížečového Location.

Location.origin je pouze pro čtení. Pro HTTP(S) obsahuje schéma, //, název hostitele a port, pokud není výchozí; cestu neobsahuje. U file: závisí výsledek na prohlížeči, proto pravidla pro HTTP(S) nevztahujte na všechna schémata. Location.pathname obsahuje cestu bez dotazu a fragmentu; u HTTP(S) začíná znakem /.

Location.search vrací neprázdný dotaz včetně úvodního znaku ?. Pokud dotaz chybí nebo je prázdný, vrací "", a to i tehdy, když URL končí samotným znakem ?. Při čtení nedochází k dekódování procentových sekvencí: %20 zůstává %20. Jednotlivé parametry přečtete pomocí new URLSearchParams(window.location.search). Location.hash vrací neprázdný fragment včetně úvodního znaku #. Pokud fragment chybí nebo je prázdný, vrací "", a to i tehdy, když URL končí samotným znakem #. Location.href vrací celou URL včetně dotazu a fragmentu.

Čtení těchto vlastností stránku nemění, ale zápis do href spustí navigaci. Změna pathname nebo search může také načíst dokument; změna pouze hash obvykle znamená navigaci v rámci stejného dokumentu. K bezpečnému prozkoumání libovolné adresy použijte URL místo úpravy window.location. Příklad používá samostatný objekt URL s odpovídajícími názvy vlastností: výsledek je pevně daný a stránka se nepřesměruje. Nejde o test navigačního chování Location.

Příklady

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]}`);
}

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje