CKTIS / JavaScript
URL.hash a URL.href: fragment a celá adresa URL
Pomocou `hash` prečítaš alebo zmeníš fragment, pomocou `href` prečítaš alebo nahradíš celú adresu URL. Zo samotného `hash` nezistíš, či je fragment prázdny alebo chýba.
Verzia: Current web platform; runtime support varies
Syntax
const url = new URL(input, base); // Omit base for an absolute input.
url.hash; // Fragment string
url.hash = fragment;
url.href; // Full serialized URL
url.href = absoluteUrl;hash a href sú vlastnosti inštancie URL, nie metódy ani statické vlastnosti. url.hash vráti neprázdny fragment s úvodným #, prípadne "", ak je fragment prázdny alebo chýba. url.href vráti celú serializovanú adresu URL vrátane reťazca dopytu, ak je prítomný. Koncové # v href odlišuje prázdny fragment od chýbajúceho.
Do url.hash môžeš priradiť text fragmentu s úvodným # alebo bez neho. Znaky ako medzery sa podľa potreby percentuálne zakódujú, ale pri čítaní sa automaticky nedekódujú. url.hash = "" odstráni fragment; url.hash = "#" ponechá prázdny fragment. Fragment nie je súčasťou reťazca dopytu: url.searchParams pracuje s parametrami dopytu a fragment sa v požiadavke HTTP automaticky neposiela serveru.
Priradením do url.href sa spracuje nová hodnota a nahradí sa celá adresa URL v tom istom objekte. Ak hodnotu nemožno spracovať ako URL, vyvolá sa TypeError. Setter nevyhodnocuje relatívne odkazy voči aktuálnej adrese; použi na to new URL(relative, base).href s platnou základnou adresou.
Zmena objektu URL nespustí navigáciu, na rozdiel od priradenia do window.location.href. Pred prechodom na nedôveryhodnú adresu over, či sú jej schéma aj pôvod povolené: úspešné spracovanie nezaručuje bezpečnosť. URL je API webovej platformy, nie súčasť ECMAScript 2024; dostupnosť závisí od prostredia vykonávania.
Príklady
{
const url = new URL("https://example.com/guide?lang=en");
const show = () => console.log(JSON.stringify([url.hash, url.href]));
url.hash = "quick start";
show();
url.hash = "#";
show();
url.hash = "";
show();
url.href = "https://example.org/start#intro";
show();
}Výsledok
["#quick%20start","https://example.com/guide?lang=en#quick%20start"] ["","https://example.com/guide?lang=en#"] ["","https://example.com/guide?lang=en"] ["#intro","https://example.org/start#intro"]
Každý riadok zobrazuje `[hash, href]`. Všimni si `%20`, koncové `#` iba v druhom riadku a nahradenie celej adresy URL v poslednom riadku.
Súvisiace lekcie
- JavaScript · Lekcia 30 · Pokročilá · Verzia: 4