CKTIS / JavaScript
URL.hash a URL.href: fragment a celá adresa URL
Pomocí `hash` přečteš nebo změníš fragment, pomocí `href` přečteš nebo nahradíš celou adresu URL. Ze samotného `hash` nepoznáš, zda je fragment prázdný, nebo chybí.
Verze: Current web platform; runtime support varies
Syntaxe
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 jsou vlastnosti instance URL, nikoli metody ani statické vlastnosti. url.hash vrací neprázdný fragment včetně úvodního #, nebo "", pokud je fragment prázdný nebo chybí. url.href vrací celou serializovanou adresu URL včetně dotazovacího řetězce, pokud je přítomen. Koncové # v href odlišuje prázdný fragment od chybějícího.
Do url.hash lze přiřadit text fragmentu s úvodním # i bez něj. Znaky jako mezery se podle potřeby kódují procentovým kódováním, ale při čtení se automaticky nedekódují. url.hash = "" fragment odstraní; url.hash = "#" ponechá prázdný fragment. Fragment není součástí dotazovacího řetězce: url.searchParams pracuje s parametry dotazu a fragment se v požadavku HTTP automaticky neposílá na server.
Přiřazení do url.href zpracuje novou hodnotu a nahradí celou adresu URL ve stejném objektu. Pokud se hodnotu nepodaří zpracovat jako URL, vyvolá se TypeError. Setter nevyhodnocuje relativní odkazy vzhledem k aktuální adrese; k tomu použij new URL(relative, base).href s platnou základní adresou.
Změna objektu URL nespustí navigaci, na rozdíl od přiřazení do window.location.href. Před přechodem na nedůvěryhodnou adresu ověř, že její schéma i původ jsou povolené: úspěšné zpracování nezaručuje bezpečnost. URL je API webové platformy, nikoli součást ECMAScript 2024; dostupnost závisí na běhovém prostředí.
Pří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ýsledek
["#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ý řádek ukazuje `[hash, href]`. Všimni si `%20`, koncového `#` pouze na druhém řádku a nahrazení celé adresy URL na posledním řádku.
Související lekce
- JavaScript · Lekce 30 · Pokročilá · Verze: 4