CKTIS / JavaScript
hashchange — zmeny fragmentu URL v objekte Window
Udalosť hashchange na window oznamuje zmenu fragmentu URL pri navigácii v rámci toho istého dokumentu. Poskytuje predchádzajúce a nové URL, no samotné volanie pushState() ani replaceState() ju nevyvolá.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.addEventListener("hashchange", handler);
window.removeEventListener("hashchange", handler);hashchange je udalosť Web API na objekte window, nie súčasť samotného ECMAScriptu. Oznamuje zmenu fragmentu URL pri navigácii v rámci toho istého dokumentu, napríklad po priradení inej hodnoty do location.hash, po nasledovaní odkazu s fragmentom alebo pri návrate či prechode vpred medzi príslušnými položkami histórie.
Funkciu zaregistrujte pomocou window.addEventListener("hashchange", handler). Udalosť HashChangeEvent má vlastnosti oldURL a newURL, ktoré obsahujú úplné URL pred zmenou a po nej. Udalosť sa doručuje asynchrónne. Tieto vlastnosti čítajte, keď potrebujete URL konkrétnej zmeny.
Volanie history.pushState() ani history.replaceState() samo osebe nevyvolá udalosť hashchange, ani keď zmení fragment. Ani opätovné nastavenie rovnakého fragmentu nie je zmenou. Nepovažujte túto udalosť za oznámenie každej zmeny URL ani za inicializáciu zobrazenia pri prvom načítaní stránky.
Príklad vyberie iný fragment a pomocou { once: true } čaká iba na jednu udalosť. Porovnáva fragmenty získané z URL udalosti, takže očakávané výsledky nezávisia od počiatočného URL stránky. Vyžaduje prostredie prehliadača; verzia Node.js v repozitári nedokazuje podporu tohto API.
Príklady
(() => {
const target = location.hash === "#cktis-a" ? "#cktis-b" : "#cktis-a";
window.addEventListener("hashchange", (event) => {
const before = new URL(event.oldURL);
const after = new URL(event.newURL);
console.log(before.hash !== after.hash);
console.log(after.hash === target);
}, { once: true });
location.hash = target;
})();Výsledok
true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.