CKTIS / JavaScript
Événements de `Window` : `popstate` et `hashchange`
Utilisez `popstate` pour lire l’état de l’entrée d’historique activée et `hashchange` pour détecter un changement de fragment d’URL dans le même document.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 et hashchange sont deux événements distincts de Window, définis par la plateforme web, et non par ECMAScript. Écoutez-les avec window.addEventListener(). Vous pouvez aussi utiliser window.onpopstate et window.onhashchange : chaque affectation remplace le gestionnaire précédemment affecté à cette propriété.
popstate signale l’activation d’une autre entrée dans l’historique de session, par exemple lors d’un retour en arrière ou d’une avance dans le même document. PopStateEvent.state contient la valeur restaurée pour l’entrée de destination, ou null si aucun état n’a été enregistré. Une navigation vers un fragment du même document peut aussi déclencher popstate. Ne comptez pas sur cet événement pour initialiser l’affichage : le navigateur peut ne pas le déclencher tant que l’utilisateur n’a pas interagi avec la page.
hashchange signale une modification du fragment d’URL dans le même document, par exemple après avoir suivi un lien vers #details ou attribué un nouveau fragment à location.hash. HashChangeEvent.oldURL et HashChangeEvent.newURL contiennent les URL complètes, pas seulement les fragments. Si une même opération déclenche les deux événements, popstate arrive en premier.
history.pushState() ajoute une entrée, tandis que history.replaceState() met à jour l’entrée actuelle. Aucun de ces appels ne déclenche l’un ou l’autre événement, même si le fragment change. Initialisez vous-même l’affichage et mettez-le à jour directement après toute modification réussie de l’historique par votre code. Si vous écoutez les deux événements, n’appliquez pas deux fois la même mise à jour.
Exemples
<!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>Résultat
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewEnregistrez l’exemple dans un fichier `index.html`, servez-le via HTTP(S) et ouvrez-le dans un onglet de test : l’exemple modifie des entrées de l’historique. Ouvrez la console de développement, puis cliquez sur « Run history demo » dans la page. Les deux écritures dans l’historique ne déclenchent aucun des deux événements ; au retour asynchrone, la console affiche l’état `overview` et le changement de fragment.
Leçons associées
- JavaScript · Leçon 36 · Intermédiaire · Version : 3
- JavaScript · Leçon 37 · Intermédiaire · Version : 3