CKTIS / JavaScript
Location.hash a Location.href: fragment versus celá adresa URL
`Location.hash` čte nebo mění fragment adresy URL. `Location.href` vrací celou adresu nebo požádá prohlížeč o navigaci na zadaný cíl.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;window.location zpřístupňuje objekt Location spojený s dokumentem. Jde o rozhraní prohlížeče definované standardem HTML, nikoli o součást ECMAScriptu 2024. Mimo kontext okna prohlížeče na jeho dostupnost nespoléhej.
Při čtení vrací hash neprázdný fragment s úvodním # a nedekóduje procentní kódování. Pokud fragment chybí nebo je prázdný, vrátí "". href vrací celou adresu URL jako řetězec, včetně dotazovací části a fragmentu, jsou-li přítomny. Na konci href může být samotný znak #, i když hash vrací "".
Přiřazení do hash mění pouze fragment; úvodní # je nepovinný. Jestliže je výsledný fragment stejný, k navigaci nedojde. Přiřazení "" nastaví prázdný fragment, místo aby ho odstranilo. Změna fragmentu při navigaci v rámci stejného dokumentu vyvolá událost hashchange bez opětovného načtení dokumentu.
Přiřazením do href určíš cíl navigace. Relativní adresa se vyhodnotí vůči základní adrese URL volajícího prostředí. Při neúspěšném parsování prohlížeč vyvolá výjimku DOMException s názvem SyntaxError. Pravidla původu omezují čtení obou vlastností i zápis do hash. Zápis do href může být povolen i mezi různými původy, ale nadále platí omezení navigace.
Příklady
(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();
}
})();Výsledek
["","about:blank"] ["#details","about:blank#details"] ["#summary","about:blank#summary"]
Kód spusť v konzoli běžné plně načtené stránky HTTP(S), která povoluje iframe bez omezení `sandbox`. Každý řádek ukazuje `[hash, href]`. Obě přiřazení mění URL rámce, nikoli URL nadřazené stránky. V Node.js příklad používá objekt `URL` místo `Location` a ukazuje pouze serializaci adresy URL, bez navigace či událostí `hashchange`.
Související lekce
- JavaScript · Lekce 30 · Pokročilá · Verze: 4