Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Window : évènement hashchange

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

L'évènement hashchange de l'interface Window est déclenché lorsque l'identificateur de fragment de l'URL a changé (la partie de l'URL commençant par et suivant le symbole #).

Cet évènement ne se déclenche pas lorsque le hash est modifié en utilisant history.pushState() ou history.replaceState().

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènements.

js
addEventListener("hashchange", (event) => { })

onhashchange = (event) => { }

Type d'évènement

Un objet HashChangeEvent. Hérite de Event.

Event HashChangeEvent

Propriétés de l'évènement

HashChangeEvent.newURL Lecture seule

Une chaîne de caractères représentant la nouvelle URL vers laquelle la fenêtre navigue.

HashChangeEvent.oldURL Lecture seule

Une chaîne de caractères représentant l'URL précédente à partir de laquelle la fenêtre a navigué.

Alias des gestionnaires d'évènements

En plus de l'interface Window, la propriété du gestionnaire d'évènements onhashchange est également disponible sur les cibles suivantes :

Exemples

Vous pouvez utiliser l'évènement hashchange dans une méthode addEventListener :

js
window.addEventListener("hashchange", () => {
  console.log("Le hash a changé !");
});

Ou utilisez la propriété du gestionnaire d'évènements onhashchange :

js
function locationHashChanged() {
  if (location.hash === "#cool-feature") {
    console.log("Vous visitez une fonctionnalité intéressante !");
  }
}

window.onhashchange = locationHashChanged;

Spécifications

Specification
HTML
# event-hashchange
HTML
# handler-window-onhashchange

Compatibilité des navigateurs

Voir aussi