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

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 = url

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

Zdroje