WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

hashchange — Änderungen des URL-Fragments in Window

Das hashchange-Ereignis auf window meldet eine Änderung des URL-Fragments bei einer Navigation innerhalb desselben Dokuments. Es stellt die vorherige und die neue URL bereit; pushState() oder replaceState() lösen das Ereignis jedoch nicht selbst aus.

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

Syntax

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

hashchange ist ein Web-API-Ereignis auf window und kein Bestandteil von ECMAScript selbst. Es meldet eine Änderung des URL-Fragments bei einer Navigation innerhalb desselben Dokuments, zum Beispiel nachdem location.hash ein anderer Wert zugewiesen wurde, beim Aufrufen eines Fragment-Links oder beim Zurück- oder Vorwärtsgehen zwischen entsprechenden Verlaufseinträgen.

Registriere eine Funktion mit window.addEventListener("hashchange", handler). Das HashChangeEvent besitzt die Eigenschaften oldURL und newURL, die die vollständigen URLs vor und nach der Änderung enthalten. Das Ereignis wird asynchron zugestellt. Lies diese Eigenschaften aus, wenn du die URLs dieser konkreten Änderung benötigst.

Der Aufruf von history.pushState() oder history.replaceState() löst hashchange nicht selbst aus, auch wenn sich dadurch das Fragment ändert. Auch das erneute Setzen desselben Fragments ist keine Änderung. Behandle dieses Ereignis weder als Meldung über jede URL-Änderung noch als Initialisierung der Ansicht beim ersten Laden der Seite.

Das Beispiel wählt ein anderes Fragment aus und lauscht mit { once: true } nur auf ein Ereignis. Es vergleicht die aus den Ereignis-URLs ermittelten Fragmente, sodass die erwarteten Ergebnisse nicht von der anfänglichen URL der Seite abhängen. Es benötigt eine Browserumgebung; die Node.js-Version des Repositorys belegt nicht, dass diese API unterstützt wird.

Beispiele

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

Ergebnis

true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen