KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Levenscyclus van een pagina: zichtbaarheid, vertrek en terugkeer

Maak onderscheid tussen een verborgen tabblad, een poging om de pagina te verlaten en herstel uit de terug-/vooruitcache, zodat je op het juiste moment opslaat, waarschuwt of werk hervat.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

document.addEventListener('visibilitychange', onVisibilityChange); // Read document.visibilityState or document.hidden.
window.addEventListener('beforeunload', onBeforeUnload); // Register only while unsaved changes exist.
window.removeEventListener('beforeunload', onBeforeUnload); // Remove the same listener once changes are saved or discarded.
window.addEventListener('pagehide', onPageHide); // Read event.persisted.
window.addEventListener('pageshow', onPageShow); // Read event.persisted.

Deze vier gebeurtenissen horen bij het webplatform, niet bij ECMAScript 2024. Ondersteuning en gedrag verschillen per browser en situatie. Ga er niet van uit dat alle vier de gebeurtenissen in een vaste volgorde optreden.

Luister naar visibilitychange op document. Deze gebeurtenis is niet annuleerbaar. Lees document.visibilityState (visible of hidden) of de booleaanse waarde document.hidden. Een ander tabblad kiezen kan de pagina verbergen zonder dat je haar verlaat. Sla de toestand tijdens het werk regelmatig op en gebruik de overgang naar hidden als beste signaal voor een laatste opslagmoment of om werk te pauzeren, niet als bewijs dat de sessie voorbij is.

beforeunload op window is een annuleerbaar BeforeUnloadEvent dat hoort bij een poging om de pagina te verlaten, opnieuw te laden of te sluiten. Roep event.preventDefault() aan om om bevestiging te vragen en stel event.returnValue in op een niet-lege tekenreeks voor compatibiliteit met oudere browsers. Een waarde teruggeven vanuit de handler werkt alleen via onbeforeunload, niet via addEventListener(). Het dialoogvenster vereist een geschikte eerdere gebruikersinteractie (sticky activation); de browser kan het onderdrukken en bepaalt de tekst. Registreer de listener alleen zolang er niet-opgeslagen wijzigingen zijn en verwijder hem na het opslaan of verwerpen ervan: hij kan het gebruik van de bfcache verhinderen, onder meer in Firefox.

pagehide en pageshow zijn niet-annuleerbare PageTransitionEvent-gebeurtenissen op window. Bij vertrek betekent pagehide met event.persisted === true dat de browser van plan is het document in het geheugen te bewaren voor terug- en vooruitnavigatie (bfcache). Herstel is niet gegarandeerd. false betekent dat de browser dit niet van plan is. Gebruik pagehide om activiteiten rond bronnen te pauzeren, niet om cruciale gegevens op te slaan: zowel deze gebeurtenis als beforeunload kan uitblijven, bijvoorbeeld als een mobiel besturingssysteem de browser op de achtergrond beëindigt.

Bij de eerste keer laden volgt pageshow op load en geldt persisted === false. Een waarde van true betekent dat hetzelfde document echt uit de bfcache is hersteld: hervat gepauzeerd werk en vernieuw gegevens die verouderd kunnen zijn. pageshow betekent niet dat de gebruiker de pagina kan zien; het kan ook optreden in een tabblad op de achtergrond.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Page lifecycle events</title>
</head>
<body>
  <label><input id="dirty" type="checkbox" autocomplete="off"> Simulate unsaved changes</label>
  <script>
    const dirty = document.getElementById('dirty');

    function warn(event) {
      console.log('beforeunload');
      event.preventDefault();
      event.returnValue = 'unsaved'; // Legacy compatibility, not dialog text.
    }

    dirty.addEventListener('change', () => {
      if (dirty.checked) {
        window.addEventListener('beforeunload', warn);
      } else {
        window.removeEventListener('beforeunload', warn);
      }
    });

    document.addEventListener('visibilitychange', () => {
      console.log(`visibilitychange: ${document.visibilityState}`);
    });
    for (const type of ['pagehide', 'pageshow']) {
      window.addEventListener(type, (event) => {
        console.log(`${type}: persisted=${event.persisted}`);
      });
    }
    console.log('ready');
  </script>
</body>
</html>

Resultaat

ready

Then, for example, after switching away from the tab and back:
visibilitychange: hidden
visibilitychange: visible

Other lines (not guaranteed and not in a fixed cross-event order):
beforeunload
pagehide: persisted=true
pageshow: persisted=true

A dispatched page transition event can also report persisted=false.

Open het voorbeeld als HTML-pagina in de browser en bekijk de console. `ready` verschijnt meteen; latere meldingen hangen af van je acties en de browser. Het selectievakje simuleert niet-opgeslagen wijzigingen, maar slaat niets op.

Gerelateerde lessen

  • JavaScript · Les 35 · Gevorderd · Versie: 4

Bronnen