CKTIS / JavaScript
Location.href — čtení adresy a navigace
Location.href zpřístupňuje URL dokumentu jako řetězec. Přiřazení hodnoty zahájí navigaci, místo aby pouze změnilo běžnou proměnnou.
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.href
window.location.href = urlLocation.href je vlastnost API prohlížeče dostupná přes window.location.href. Při čtení vrací serializovanou URL dokumentu, včetně dotazu a fragmentu, pokud jsou přítomné.
Přiřazení window.location.href = url zahájí navigaci. Relativní adresa se při přiřazení vyhodnotí vůči základní URL rozhraní API vstupního objektu nastavení (entry settings object). Při synchronním volání mezi rámci to může být základní URL rámce, který volání zahájil, nikoli rámce, jehož kód provádí přiřazení. Neplatná adresa může vyvolat DOMException typu SyntaxError.
Čtení adresy jiného okna podléhá omezením původu a může vyvolat SecurityError. Příklad pouze čte adresu; stránku neopouští.
Příklady
const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());Výsledek
string true
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.