CKTIS / JavaScript
URL.hash in URL.href: fragment in celoten URL
Z `hash` prebereš ali spremeniš fragment, s `href` pa prebereš ali zamenjaš celoten URL. Samo iz `hash` ne moreš ugotoviti, ali je fragment prazen ali ga ni.
Različica: Current web platform; runtime support varies
Sintaksa
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 in href sta lastnosti primerka URL, ne metodi ali statični lastnosti. url.hash vrne neprazen fragment z začetnim znakom # oziroma "", če je fragment prazen ali ga ni. url.href vrne celoten serializiran URL, vključno s poizvedbenim nizom, če obstaja. Končni # v href omogoča razlikovanje med praznim in manjkajočim fragmentom.
Lastnosti url.hash prirediš besedilo fragmenta z začetnim znakom # ali brez njega. Znaki, kot so presledki, se po potrebi odstotkovno kodirajo, pri branju pa se ne dekodirajo samodejno. url.hash = "" odstrani fragment; url.hash = "#" pusti prazen fragment. Fragment je ločen od poizvedbenega niza: url.searchParams je namenjen delu s parametri poizvedbe, fragment pa se v zahtevi HTTP ne pošlje samodejno strežniku.
Prireditev vrednosti lastnosti url.href razčleni novo vrednost in zamenja celoten URL v istem objektu. Če razčlenjevanje ne uspe, se sproži TypeError. Nastavljalnik relativnih sklicev ne razreši glede na trenutni URL; za to uporabi new URL(relative, base).href z veljavnim osnovnim URL-jem.
Sprememba objekta URL ne sproži navigacije, v nasprotju s prireditvijo vrednosti lastnosti window.location.href. Pred navigacijo na nezaupanja vreden URL preveri, ali sta njegova shema in izvor dovoljena: uspešno razčlenjevanje še ne pomeni, da je URL varen. URL je API spletne platforme, ne del ECMAScript 2024; razpoložljivost je odvisna od izvajalnega okolja.
Primeri
{
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();
}Rezultat
["#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"]
Vsaka vrstica prikaže `[hash, href]`. Opazi `%20`, končni `#` samo v drugi vrstici in zamenjavo celotnega URL-ja v zadnji vrstici.
Povezane lekcije
- JavaScript · Lekcija 30 · Napredna · Različica: 4