Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

hashchange — changements du fragment d’URL dans Window

L’événement hashchange sur window signale un changement du fragment d’URL lors d’une navigation dans le même document. Il fournit les URL précédente et nouvelle, mais un appel à pushState() ou replaceState() ne le déclenche pas à lui seul.

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

Syntaxe

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

hashchange est un événement de l’API Web sur window, et non une partie d’ECMAScript. Il signale un changement du fragment d’URL lors d’une navigation dans le même document, par exemple après l’attribution d’une nouvelle valeur à location.hash, le suivi d’un lien avec fragment ou un déplacement avec Précédent/Suivant entre des entrées d’historique pertinentes.

Enregistre une fonction avec window.addEventListener("hashchange", handler). Son HashChangeEvent possède les propriétés oldURL et newURL, qui contiennent les URL complètes avant et après le changement. L’événement est envoyé de manière asynchrone. Lis ces propriétés lorsque tu as besoin des URL correspondant à ce changement précis.

L’appel de history.pushState() ou de history.replaceState() ne déclenche pas à lui seul hashchange, même s’il modifie le fragment. Réattribuer le même fragment ne constitue pas non plus un changement. Ne considère pas cet événement comme une notification de chaque changement d’URL ni comme une initialisation de la vue au premier chargement de la page.

L’exemple choisit un fragment différent et n’écoute qu’un seul événement grâce à { once: true }. Il compare les fragments extraits des URL de l’événement ; les résultats attendus ne dépendent donc pas de l’URL initiale de la page. Il nécessite un environnement de navigateur ; la version Node.js du dépôt ne permet pas d’établir la prise en charge de cette API.

Exemples

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

Résultat

true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources