CKTIS / JavaScript
Location: fragment, původ, cesta, dotaz a úplná URL
Přečti pět vlastností URL dokumentu a rozliš, která přiřazení mohou spustit navigaci v prohlížeči.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const loc = window.location;
loc.hash; // string: fragment
loc.origin; // string: URL origin (read-only)
loc.pathname; // string: path
loc.search; // string: query
loc.href; // string: complete URL
// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";window.location vrací objekt Location spojený s dokumentem. Jde o webové API prohlížeče, nikoli o součást ECMAScriptu 2024. Objekt odráží aktuální URL dokumentu, ale dříve přečtený řetězec se neaktualizuje. Pomocí new URL(window.location.href) můžeš zkoumat nebo upravovat samostatnou URL bez navigace.
href je úplná serializovaná URL. pathname obsahuje jen cestu, bez dotazu a fragmentu. U HTTP(S) začíná znakem /, a to i v kořeni. Neprůhledná cesta, například blank v about:blank, úvodní lomítko mít nemusí. search vrací neprázdný dotaz s úvodním ? a hash neprázdný fragment s úvodním #. Chybí-li příslušná část nebo je-li prázdná, výsledkem je "", i když v href zůstává samotný oddělovač. Při čtení se procentové kódování nedekóduje. Jednotlivé parametry dotazu přečteš pomocí new URLSearchParams(window.location.search).
origin je pouze pro čtení a popisuje původ URL. U HTTP(S) obsahuje schéma, název hostitele a port, pokud není výchozí. Neprůhledný původ URL se serializuje jako řetězec "null", nikoli jako hodnota null. Naproti tomu self.origin popisuje původ běhového prostředí: dokument about:blank jej může zdědit. Dva shodné řetězce "null" neprokazují shodu původů.
Přiřazení do href může spustit navigaci na jinou, i relativní URL. Pokud se ji nepodaří zpracovat, vyvolá se DOMException s názvem SyntaxError. Přiřazení do pathname nebo search může spustit navigaci se změněnou cestou nebo dotazem. U neprůhledné cesty nemá přiřazení do pathname žádný účinek. Při zápisu do search a hash je úvodní ?, respektive #, nepovinné. search = "" dotaz odstraní, ale hash = "" může na konci ponechat #. Změna samotného fragmentu obvykle nenačítá nový dokument.
Při čtení kterékoli z těchto pěti vlastností v okně s jiným původem může nastat DOMException s názvem SecurityError. Zápis do href je výjimka: může být povolen i bez přístupu ke čtení, omezení navigace v prohlížeči však platí dál.
Příklady
const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));Výsledek
{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}Spusť kód v Node.js. Kód čte stejné části URL z objektu `URL` místo z objektu `Location` prohlížeče a nespouští navigaci. Ve výstupu je `"null"` řetězec a `blank` nezačíná znakem `/`.
Související lekce
- JavaScript · Lekce 38 · Pokročilá · Verze: 4