CKTIS / JavaScript
Location.hash in Location.href: fragment ali celoten URL
`Location.hash` prebere ali spremeni fragment URL-ja. `Location.href` vrne celoten URL ali zahteva navigacijo na izbrani naslov.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;window.location omogoča dostop do objekta Location, povezanega z dokumentom. To je brskalniški API, ki ga določa standard HTML, ne ECMAScript 2024. Zunaj konteksta brskalniškega okna ne računaj na njegovo razpoložljivost.
Pri branju hash vrne neprazen fragment z začetnim znakom #, ne da bi dekodiral odstotkovno kodirane znake. Če fragment manjka ali je prazen, vrne "". href vrne celoten URL kot niz, vključno s poizvedbo in fragmentom, če sta prisotna. Na koncu href je lahko sam znak #, čeprav je hash enak "".
Prirejanje vrednosti lastnosti hash spremeni samo fragment; začetni # ni obvezen. Če nastali fragment ostane enak, se navigacija ne izvede. Prireditev "" nastavi prazen fragment, namesto da bi ga odstranila. Sprememba fragmenta z navigacijo znotraj istega dokumenta sproži dogodek hashchange brez ponovnega nalaganja dokumenta.
Prireditev vrednosti lastnosti href določi cilj navigacije. Relativni URL se razreši glede na osnovni URL okolja, ki izvede prireditev. Če razčlenjevanje ne uspe, brskalnik sproži izjemo DOMException z imenom SyntaxError. Pravila o izvoru omejujejo branje obeh lastnosti in pisanje v hash. Pisanje v href je lahko dovoljeno tudi med različnimi izvori, vendar še vedno veljajo omejitve navigacije.
Primeri
(async () => {
const show = address => console.log(JSON.stringify([address.hash, address.href]));
if (typeof document === 'undefined') {
// Node.js: URL serialization only, without navigation or hashchange.
const url = new URL('about:blank');
show(url);
url.hash = 'details';
show(url);
url.href = 'about:blank#summary';
show(url);
return;
}
const frame = document.createElement('iframe');
frame.hidden = true;
document.body.append(frame);
try {
const child = frame.contentWindow;
const location = child.location;
const nextHashChange = () => new Promise(resolve => {
child.addEventListener('hashchange', resolve, { once: true });
});
show(location);
const firstChange = nextHashChange();
location.hash = 'details';
await firstChange;
show(location);
const secondChange = nextHashChange();
location.href = 'about:blank#summary';
await secondChange;
show(location);
} finally {
frame.remove();
}
})();Rezultat
["","about:blank"] ["#details","about:blank#details"] ["#summary","about:blank#summary"]
Kodo zaženi v konzoli običajne, v celoti naložene strani HTTP(S), ki dovoljuje iframe brez omejitev `sandbox`. Vsaka vrstica prikaže `[hash, href]`. Obe prireditvi spremenita URL okvirja, ne pa URL-ja nadrejene strani. V okolju Node.js primer namesto objekta `Location` uporabi objekt `URL` in prikaže le serializacijo URL-ja, brez navigacije ali dogodkov `hashchange`.
Povezane lekcije
- JavaScript · Lekcija 30 · Napredna · Različica: 4