CKTIS / JavaScript
hashchange — změny fragmentu URL v objektu Window
Událost hashchange na window oznamuje změnu fragmentu URL při navigaci v rámci stejného dokumentu. Poskytuje předchozí a nový URL, ale samotné volání pushState() ani replaceState() ji nevyvolá.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.addEventListener("hashchange", handler);
window.removeEventListener("hashchange", handler);hashchange je událost Web API na objektu window, nikoli součást samotného ECMAScriptu. Oznamuje změnu fragmentu URL při navigaci v rámci stejného dokumentu, například po přiřazení jiné hodnoty do location.hash, po přechodu na odkaz s fragmentem nebo při návratu či přechodu vpřed mezi odpovídajícími položkami historie.
Funkci zaregistrujte pomocí window.addEventListener("hashchange", handler). Událost HashChangeEvent má vlastnosti oldURL a newURL, které obsahují úplné URL před změnou a po ní. Událost se doručuje asynchronně. Tyto vlastnosti čtěte, když potřebujete URL pro danou konkrétní změnu.
Volání history.pushState() ani history.replaceState() samo o sobě událost hashchange nevyvolá, ani když změní fragment. Ani opětovné nastavení stejného fragmentu není změnou. Nepovažujte tuto událost za oznámení každé změny URL ani za inicializaci zobrazení při prvním načtení stránky.
Příklad vybere jiný fragment a pomocí { once: true } čeká jen na jednu událost. Porovnává fragmenty získané z URL události, takže očekávané výsledky nezávisí na počátečním URL stránky. Vyžaduje prostředí prohlížeče; verze Node.js v repozitáři nedokládá podporu tohoto API.
Pří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ýsledek
true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.