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.hrefwindow.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.