KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

De gebeurtenissen wheel, pagehide, pageshow en beforeunload

Onderscheid invoer via muiswiel of trackpad van scrollen, herken herstel uit de navigatiecache en waarschuw bij niet-opgeslagen wijzigingen.

Versie: 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);

Deze gebeurtenissen horen bij browser-API’s, niet bij ECMAScript 2024. Luister naar wheel op een element en naar pagehide, pageshow en beforeunload op window. Details van het gedrag verschillen per browser.

wheel (WheelEvent) meldt een gebaar met het muiswiel of trackpad, geen daadwerkelijke scrollbeweging: het gebaar kan zoomen of niets verplaatsen, terwijl je ook met het toetsenbord kunt scrollen. deltaX en deltaY beschrijven het gebaar; deltaMode geeft de eenheid aan: 0 voor pixels, 1 voor regels en 2 voor pagina’s. Vergelijk scrollLeft en scrollTop in een scroll-listener om echte verplaatsing te meten. Gebruik { passive: true } om alleen te observeren. Als je standaard scrollen of zoomen moet blokkeren, gebruik dan { passive: false } en roep preventDefault() alleen aan als event.cancelable waar is. In sommige browsers kun je alleen de eerste gebeurtenis van een reeks annuleren.

pagehide en pageshow zijn van het type PageTransitionEvent. Bij het verlaten van de pagina betekent pagehide met persisted: true dat de pagina in de terug-/vooruitcache (bfcache) kan blijven, niet dat later herstel zeker is. pageshow met persisted: true betekent dat dezelfde pagina vanuit de bfcache is hervat; bij de eerste keer laden volgt pageshow op load en is persisted: false. Geen van beide volgt gewone tabbladwissels, en pageshow bewijst niet dat de pagina zichtbaar is. preventDefault() stopt deze overgangen niet.

beforeunload (BeforeUnloadEvent) kan plaatsvinden vóór het sluiten, herladen of verlaten van de pagina. Roep preventDefault() aan om een bevestigingsvenster te vragen; stel voor oudere browsers ook event.returnValue in op een niet-lege tekenreeks. Een niet-lege tekenreeks teruggeven vanuit de handler is een ouder mechanisme voor onbeforeunload, niet voor addEventListener(). Het venster vereist eerdere gebruikersinteractie (blijvende activering), verschijnt niet gegarandeerd en gebruikt tekst die de browser bepaalt.

Registreer beforeunload alleen zolang er niet-opgeslagen wijzigingen zijn en verwijder de listener na het opslaan of weggooien. Zowel pagehide als beforeunload is onbetrouwbaar, vooral op mobiele apparaten. Sla tijdens het werken tussentijds op en gebruik visibilitychange op document wanneer document.visibilityState === "hidden" als extra aanwijzing om op te slaan, niet als bewijs dat de sessie is afgelopen.

Voorbeelden

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

Resultaat

wheel: deltaY=3, deltaMode=1, canceled=true
pagehide: persisted=true
pageshow: persisted=true
beforeunload: dispatchEvent returned false

Voer de code uit in de browserconsole of in Node.js 24. In de browser gaat de synthetische `wheel`-gebeurtenis naar een element dat niet aan het document is gekoppeld. In Node.js vervangt een `EventTarget` het element en krijgen gewone `Event`-objecten de eigenschappen van `wheel`, `pagehide` en `pageshow`. In beide omgevingen vervangt een afzonderlijk `EventTarget` het object `window`. `false` betekent dat de testgebeurtenis is geannuleerd, niet dat navigatie is geblokkeerd. De code scrollt niet, herstelt geen pagina uit de bfcache en opent geen dialoogvenster.

Gerelateerde lessen

  • JavaScript · Les 36 · Gevorderd · Versie: 4

Bronnen