CKTIS / JavaScript
Location: fragment, pôvod, cesta, dopyt a úplná URL
Prečítaj päť vlastností URL dokumentu a rozlíš, ktoré priradenia môžu spustiť navigáciu v prehliadači.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 vracia objekt Location priradený k dokumentu. Je to webové API prehliadača, nie súčasť ECMAScriptu 2024. Objekt odráža aktuálnu URL dokumentu, ale už prečítaný reťazec sa neaktualizuje. Pomocou new URL(window.location.href) môžeš skúmať alebo meniť samostatnú URL bez navigácie.
href je úplná serializovaná URL. pathname obsahuje iba cestu, bez dopytu a fragmentu. Pri HTTP(S) sa začína znakom /, aj pri koreňovej ceste. Nepriehľadná cesta, napríklad blank v about:blank, nemusí mať úvodnú lomku. search vracia neprázdny dopyt s úvodným ? a hash neprázdny fragment s úvodným #. Ak príslušná časť chýba alebo je prázdna, výsledkom je "", aj keď v href zostal samotný oddeľovač. Pri čítaní sa percentové kódovanie nedekóduje. Jednotlivé parametre dopytu prečítaš pomocou new URLSearchParams(window.location.search).
origin je iba na čítanie a opisuje pôvod URL. Pri HTTP(S) obsahuje schému, názov hostiteľa a port, ak nie je predvolený. Nepriehľadný pôvod URL sa serializuje ako reťazec "null", nie ako hodnota null. Naopak self.origin opisuje pôvod prostredia vykonávania: dokument about:blank ho môže zdediť. Dva rovnaké reťazce "null" nedokazujú, že pôvody sú rovnaké.
Priradenie do href môže spustiť navigáciu na inú URL, aj relatívnu. Ak sa URL nepodarí spracovať, vyvolá sa DOMException s názvom SyntaxError. Priradenie do pathname alebo search môže spustiť navigáciu so zmenenou cestou alebo dopytom. Pri nepriehľadnej ceste nemá priradenie do pathname žiadny účinok. Pri zápise do search a hash je úvodné ?, respektíve #, nepovinné. search = "" dopyt odstráni, ale hash = "" môže na konci ponechať #. Zmena iba fragmentu zvyčajne nenačíta nový dokument.
Čítanie ktorejkoľvek z týchto piatich vlastností v okne s iným pôvodom môže vyvolať DOMException s názvom SecurityError. Zápis do href je výnimka: môže byť povolený aj bez prístupu na čítanie, no obmedzenia navigácie prehliadača stále platia.
Príklady
const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));Výsledok
{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}Spusť kód v Node.js. Kód číta tie isté časti URL z objektu `URL` namiesto objektu `Location` prehliadača a nespúšťa navigáciu. Vo výstupe je `"null"` reťazec a `blank` sa nezačína znakom `/`.
Súvisiace lekcie
- JavaScript · Lekcia 38 · Pokročilá · Verzia: 4