CKTIS / JavaScript
Die Ereignisse wheel, pagehide, pageshow und beforeunload
Unterscheide Mausrad- und Trackpad-Gesten vom Scrollen, erkenne eine Wiederherstellung aus dem Verlaufscache und warne vor ungespeicherten Änderungen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.addEventListener("wheel", onWheel, { passive: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
window.addEventListener("beforeunload", onBeforeUnload);
window.removeEventListener("beforeunload", onBeforeUnload);Diese Ereignisse gehören zu den Browser-APIs, nicht zu ECMAScript 2024. Registriere wheel auf einem Element und pagehide, pageshow und beforeunload auf window. Verhaltensdetails hängen vom Browser ab.
wheel (WheelEvent) meldet eine Mausrad- oder Trackpad-Geste, keine tatsächliche Scrollbewegung: Die Geste kann zoomen oder nichts verschieben; mit der Tastatur lässt sich auch ohne sie scrollen. deltaX und deltaY beschreiben die Geste; deltaMode gibt die Einheit an: 0 für Pixel, 1 für Zeilen, 2 für Seiten. Vergleiche in einem scroll-Listener scrollLeft und scrollTop, um tatsächliche Bewegungen zu erkennen. Verwende zum Beobachten { passive: true }. Falls du das standardmäßige Scrollen oder Zoomen verhindern musst, verwende { passive: false } und rufe preventDefault() nur auf, wenn event.cancelable wahr ist. Manche Browser lassen nur das erste Ereignis einer Folge abbrechen.
pagehide und pageshow sind vom Typ PageTransitionEvent. Beim Verlassen der Seite bedeutet pagehide mit persisted: true, dass sie im Vor-/Zurück-Cache (bfcache) bleiben kann, nicht dass sie später sicher wiederhergestellt wird. pageshow mit persisted: true bedeutet, dass dieselbe Seite aus dem bfcache fortgesetzt wurde. Beim ersten Laden folgt pageshow auf load und hat persisted: false. Keines der Ereignisse erfasst gewöhnliche Tabwechsel, und pageshow belegt keine Sichtbarkeit. preventDefault() stoppt diese Übergänge nicht.
beforeunload (BeforeUnloadEvent) kann vor dem Schließen, Neuladen oder Verlassen der Seite ausgelöst werden. Fordere mit preventDefault() einen Bestätigungsdialog an und setze für ältere Browser zusätzlich event.returnValue auf eine nicht leere Zeichenkette. Die Rückgabe einer nicht leeren Zeichenkette aus dem Handler ist ein älterer Mechanismus für onbeforeunload, nicht für addEventListener(). Der Dialog setzt eine vorherige Nutzerinteraktion voraus (Sticky Activation), erscheint nicht garantiert und verwendet einen vom Browser vorgegebenen Text.
Registriere beforeunload nur bei ungespeicherten Änderungen und entferne den Listener nach dem Speichern oder Verwerfen. Weder pagehide noch beforeunload ist zuverlässig, besonders auf Mobilgeräten. Speichere schon während der Bearbeitung und nutze visibilitychange auf document bei document.visibilityState === "hidden" als zusätzlichen Speicheranlass, nicht als Beweis für das Sitzungsende.
Beispiele
(() => {
const element = typeof document === "undefined"
? new EventTarget()
: document.createElement("div");
const page = new EventTarget();
element.addEventListener("wheel", (event) => {
const unit = event.deltaMode;
if (event.cancelable) event.preventDefault();
console.log(`wheel: deltaY=${event.deltaY}, deltaMode=${unit}, canceled=${event.defaultPrevented}`);
}, { passive: false });
const logTransition = (event) => {
console.log(`${event.type}: persisted=${event.persisted}`);
};
page.addEventListener("pagehide", logTransition);
page.addEventListener("pageshow", logTransition);
page.addEventListener("beforeunload", (event) => event.preventDefault());
const wheel = typeof WheelEvent === "function"
? new WheelEvent("wheel", {
deltaY: 3, deltaMode: WheelEvent.DOM_DELTA_LINE, cancelable: true
})
: Object.assign(new Event("wheel", { cancelable: true }), {
deltaY: 3, deltaMode: 1 // Lines, as with WheelEvent.DOM_DELTA_LINE.
});
const transition = (type) => typeof PageTransitionEvent === "function"
? new PageTransitionEvent(type, { persisted: true })
: Object.assign(new Event(type), { persisted: true });
element.dispatchEvent(wheel);
page.dispatchEvent(transition("pagehide"));
page.dispatchEvent(transition("pageshow"));
const result = page.dispatchEvent(new Event("beforeunload", { cancelable: true }));
console.log(`beforeunload: dispatchEvent returned ${result}`);
})();Ergebnis
wheel: deltaY=3, deltaMode=1, canceled=true pagehide: persisted=true pageshow: persisted=true beforeunload: dispatchEvent returned false
Führe den Code in einer Browserkonsole oder in Node.js 24 aus. Im Browser wird das synthetische `wheel`-Ereignis an ein nicht eingebundenes Element gesendet. In Node.js ersetzt ein `EventTarget` das Element, und die Eigenschaften für `wheel`, `pagehide` und `pageshow` werden auf einfachen `Event`-Objekten gesetzt. In beiden Umgebungen steht ein separates `EventTarget` für `window`. `false` bedeutet, dass das Testereignis abgebrochen wurde, nicht dass die Navigation gestoppt wurde. Der Code scrollt nicht, stellt keine Seite aus dem bfcache wieder her und öffnet keinen Dialog.
Zugehörige Lektionen
- JavaScript · Lektion 36 · Fortgeschritten · Version: 4
Quellen
- Element: wheel event
- WheelEvent: deltaMode property
- WheelEvent: WheelEvent() constructor
- Window: pagehide event
- Window: pageshow event
- HTML Standard: The PageTransitionEvent interface
- Window: beforeunload event
- HTML Standard: Preventing navigation
- Document: visibilitychange event
- EventTarget: dispatchEvent() method