CKTIS / JavaScript
`Window`-Ereignisse: `popstate` und `hashchange`
Lies mit `popstate` den Zustand des aktivierten Verlaufseintrags und erkenne mit `hashchange`, ob sich das URL-Fragment im selben Dokument geändert hat.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 und hashchange sind zwei verschiedene Ereignisse auf Window. Sie gehören zur Webplattform, nicht zu ECMAScript. Registriere Listener mit window.addEventListener(). Alternativ kannst du window.onpopstate und window.onhashchange verwenden: Jede neue Zuweisung ersetzt den zuvor dieser Eigenschaft zugewiesenen Handler.
popstate meldet die Aktivierung eines anderen Eintrags im Sitzungsverlauf, etwa beim Zurück- oder Vorwärtsgehen im selben Dokument. PopStateEvent.state enthält den wiederhergestellten Wert des Zieleintrags oder null, wenn kein Zustand gespeichert wurde. Auch eine Fragmentnavigation im selben Dokument kann popstate auslösen. Verlasse dich für die Initialisierung der Ansicht nicht darauf: Der Browser kann das Ereignis bis zur ersten Interaktion mit der Seite unterdrücken.
hashchange meldet eine Änderung des URL-Fragments im selben Dokument, etwa nach einem Klick auf einen Link zu #details oder wenn du location.hash auf ein neues Fragment setzt. HashChangeEvent.oldURL und HashChangeEvent.newURL sind vollständige URLs, nicht nur Fragmente. Löst derselbe Vorgang beide Ereignisse aus, kommt popstate zuerst.
history.pushState() fügt einen Eintrag hinzu, history.replaceState() aktualisiert den aktuellen Eintrag. Keiner der beiden Aufrufe löst selbst eines dieser Ereignisse aus, auch wenn er das Fragment ändert. Rendere die Ansicht zu Beginn selbst und aktualisiere sie nach einer erfolgreichen Verlaufsänderung direkt. Wenn du auf beide Ereignisse hörst, führe dieselbe Aktualisierung nicht zweimal aus.
Beispiele
<!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>Ergebnis
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewSpeichere das Beispiel als `index.html`, stelle es über HTTP(S) bereit und öffne es in einem separaten Test-Tab: Das Beispiel verändert Verlaufseinträge. Öffne die Entwicklerkonsole und klicke auf der Seite auf „Run history demo“. Die beiden Verlaufsänderungen lösen keines der Ereignisse aus; beim asynchronen Zurückgehen werden der Zustand `overview` und der Fragmentwechsel ausgegeben.
Zugehörige Lektionen
- JavaScript · Lektion 36 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 37 · Mittlere Stufe · Version: 3