Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

hashchange — modifiche del frammento URL in Window

L’evento hashchange su window segnala una modifica del frammento URL durante la navigazione nello stesso documento. Fornisce gli URL precedente e nuovo, ma una chiamata a pushState() o replaceState() non lo attiva da sola.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

window.addEventListener("hashchange", handler);
window.removeEventListener("hashchange", handler);

hashchange è un evento della Web API su window, non una parte di ECMAScript. Segnala una modifica del frammento URL durante la navigazione nello stesso documento, per esempio dopo aver assegnato un valore diverso a location.hash, aver seguito un collegamento con frammento o essere tornati indietro o avanti tra voci pertinenti della cronologia.

Registra una funzione con window.addEventListener("hashchange", handler). Il suo HashChangeEvent ha le proprietà oldURL e newURL, che contengono gli URL completi prima e dopo la modifica. L’evento viene recapitato in modo asincrono. Leggi queste proprietà quando ti servono gli URL relativi a quella specifica modifica.

La chiamata a history.pushState() o history.replaceState() non attiva da sola hashchange, anche se modifica il frammento. Anche impostare di nuovo lo stesso frammento non è una modifica. Non considerare questo evento una notifica di ogni cambiamento dell’URL né un’inizializzazione della vista al primo caricamento della pagina.

L’esempio sceglie un frammento diverso e attende un solo evento usando { once: true }. Confronta i frammenti ricavati dagli URL dell’evento, quindi i risultati previsti non dipendono dall’URL iniziale della pagina. Richiede un ambiente browser; la versione Node.js del repository non dimostra il supporto per questa API.

Esempi

(() => {
  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;
})();

Risultato

true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti