Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje