CKTIS / JavaScript
Location.hash i Location.href: fragment ili cijeli URL
`Location.hash` čita ili mijenja fragment URL-a. `Location.href` vraća cijeli URL ili traži navigaciju na zadano odredište.
Verzija: 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 omogućuje pristup objektu Location povezanom s dokumentom. To je API preglednika definiran standardom HTML, a ne dio ECMAScripta 2024. Ne pretpostavljaj da je dostupan izvan konteksta prozora preglednika.
Pri čitanju hash vraća neprazan fragment s početnim znakom # bez dekodiranja postotno kodiranih nizova. Ako fragment nedostaje ili je prazan, vraća "". href vraća cijeli URL kao niz znakova, uključujući upit i fragment ako postoje. Na kraju vrijednosti href može stajati sam znak # iako je hash jednak "".
Dodjela vrijednosti svojstvu hash mijenja samo fragment; početni # nije obvezan. Ako dobiveni fragment ostane isti, nema navigacije. Dodjela "" postavlja prazan fragment umjesto da ga ukloni. Promjena fragmenta navigacijom unutar istog dokumenta pokreće događaj hashchange bez ponovnog učitavanja dokumenta.
Dodjela vrijednosti svojstvu href određuje odredište navigacije. Relativni URL razrješava se prema osnovnom URL-u okruženja koje izvršava dodjelu. Ako raščlamba ne uspije, preglednik baca iznimku DOMException naziva SyntaxError. Pravila o podrijetlu ograničavaju čitanje obaju svojstava i pisanje u hash. Pisanje u href može biti dopušteno između različitih podrijetla, ali i dalje vrijede ograničenja navigacije.
Primjeri
(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"]
Pokreni kod u konzoli obične, potpuno učitane HTTP(S) stranice koja dopušta iframe bez ograničenja `sandbox`. Svaki redak prikazuje `[hash, href]`. Obje dodjele mijenjaju URL okvira, a ne URL nadređene stranice. U okruženju Node.js primjer koristi objekt `URL` umjesto objekta `Location` i prikazuje samo serijalizaciju URL-a, bez navigacije ili događaja `hashchange`.
Povezane lekcije
- JavaScript · Lekcija 30 · Napredno · Verzija: 4