CKTIS / JavaScript
hashchange — spremembe fragmenta URL v objektu Window
Dogodek hashchange na window sporoča spremembo fragmenta URL med navigacijo znotraj istega dokumenta. Poda prejšnji in novi URL, vendar ga klic pushState() ali replaceState() ne sproži samodejno.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
window.addEventListener("hashchange", handler);
window.removeEventListener("hashchange", handler);hashchange je dogodek spletnega API-ja na objektu window, ne del samega ECMAScripta. Sporoča spremembo fragmenta URL med navigacijo znotraj istega dokumenta, na primer po dodelitvi drugačne vrednosti location.hash, ob sledenju povezavi s fragmentom ali ob premiku nazaj oziroma naprej med ustreznimi vnosi v zgodovini.
Funkcijo registriraj z window.addEventListener("hashchange", handler). Dogodek HashChangeEvent ima lastnosti oldURL in newURL, ki vsebujeta celotna URL-ja pred spremembo in po njej. Dogodek se dostavi asinhrono. Ti lastnosti preberi, kadar potrebuješ URL-ja za to konkretno spremembo.
Klic history.pushState() ali history.replaceState() sam po sebi ne sproži dogodka hashchange, tudi če spremeni fragment. Tudi ponovna nastavitev istega fragmenta ni sprememba. Tega dogodka ne obravnavaj kot obvestilo o vsaki spremembi URL-ja ali kot inicializacijo pogleda ob prvem nalaganju strani.
Primer izbere drug fragment in z { once: true } posluša samo en dogodek. Primerja fragmenta, razčlenjena iz URL-jev dogodka, zato pričakovani rezultati niso odvisni od začetnega URL-ja strani. Potrebuje brskalniško okolje; različica Node.js v repozitoriju ne potrjuje podpore za ta API.
Primeri
(() => {
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;
})();Rezultat
true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.