Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri