CKTIS / JavaScript
Eventi di `Window`: `popstate` e `hashchange`
Usa `popstate` per leggere lo stato della voce di cronologia attivata e `hashchange` per rilevare un cambio del frammento dell’URL nello stesso documento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
window.addEventListener("popstate", handlePopState); // PopStateEvent: event.state
window.addEventListener("hashchange", handleHashChange); // HashChangeEvent: event.oldURL, event.newURL
// Alternative: assign one handler per property.
window.onpopstate = handlePopState;
window.onhashchange = handleHashChange;popstate e hashchange sono due eventi distinti di Window, definiti dalla piattaforma web, non da ECMAScript. Registrali con window.addEventListener(). In alternativa puoi usare window.onpopstate e window.onhashchange: assegnare un nuovo gestore a una proprietà sostituisce quello assegnato in precedenza alla stessa proprietà.
popstate segnala l’attivazione di un’altra voce della cronologia di sessione, ad esempio quando si va indietro o avanti nello stesso documento. PopStateEvent.state contiene il valore ripristinato della voce di destinazione, oppure null se non è stato salvato alcuno stato. Anche la navigazione a un frammento dello stesso documento può generare popstate. Non affidarti a questo evento per inizializzare la vista: il browser potrebbe non emetterlo finché l’utente non interagisce con la pagina.
hashchange segnala una modifica del frammento dell’URL nello stesso documento, ad esempio quando si segue un link a #details o si assegna un nuovo frammento a location.hash. HashChangeEvent.oldURL e HashChangeEvent.newURL sono URL completi, non solo frammenti. Se la stessa operazione genera entrambi gli eventi, popstate arriva per primo.
history.pushState() aggiunge una voce, mentre history.replaceState() aggiorna quella corrente. Nessuna delle due chiamate genera direttamente uno di questi eventi, anche se cambia il frammento. Mostra la vista iniziale e aggiornala direttamente dopo ogni modifica della cronologia riuscita nel tuo codice. Se ascolti entrambi gli eventi, evita di applicare due volte lo stesso aggiornamento.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>History events demo</title>
</head>
<body>
<button id="run-history-demo" type="button">Run history demo</button>
<script>
(() => {
const button = document.getElementById("run-history-demo");
button.addEventListener("click", () => {
button.remove();
window.addEventListener("popstate", (event) => {
console.log(`popstate: ${JSON.stringify(event.state)}`);
}, { once: true });
window.addEventListener("hashchange", (event) => {
const from = new URL(event.oldURL).hash;
const to = new URL(event.newURL).hash;
console.log(`hashchange: ${from} -> ${to}`);
}, { once: true });
history.replaceState({ view: "overview" }, "", "#overview");
history.pushState({ view: "details" }, "", "#details");
console.log(`after writes: ${location.hash}`);
history.back();
}, { once: true });
})();
</script>
</body>
</html>Risultato
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewSalva l’esempio come `index.html`, servilo tramite HTTP(S) e aprilo in una scheda di prova: l’esempio modifica le voci della cronologia. Apri la console di sviluppo e fai clic su «Run history demo» nella pagina. Le due scritture nella cronologia non generano nessuno dei due eventi; al ritorno asincrono la console mostra lo stato `overview` e il cambio di frammento.
Lezioni correlate
- JavaScript · Lezione 36 · Intermedio · Versione: 3
- JavaScript · Lezione 37 · Intermedio · Versione: 3