Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Životní cyklus stránky: viditelnost, opuštění a návrat

Rozliš skrytí karty, pokus o opuštění stránky a obnovení z mezipaměti pro návrat a přechod vpřed, abys ve správný okamžik ukládal stav, varoval nebo pokračoval v práci.

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

Syntaxe

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.

Tyto čtyři události patří k webové platformě, nikoli k ECMAScriptu 2024. Podpora a chování závisejí na prohlížeči a situaci. Nespoléhej na to, že nastanou všechny a v pevném pořadí.

Naslouchej události visibilitychange na document. Tuto událost nelze zrušit. Přečti document.visibilityState (visible nebo hidden) nebo logickou hodnotu document.hidden. Přepnutí karty může stránku skrýt, aniž ji opustíš. Ukládej stav průběžně a přechod do hidden ber jako nejlepší signál k poslednímu uložení nebo pozastavení práce, ne jako důkaz konce relace.

beforeunload na window je zrušitelná událost typu BeforeUnloadEvent spojená s pokusem stránku opustit, znovu načíst nebo zavřít. Chceš-li požádat o potvrzení, zavolej event.preventDefault() a pro kompatibilitu se staršími prohlížeči nastav event.returnValue na neprázdný řetězec. Vrácení hodnoty z obslužné funkce funguje jen přes onbeforeunload, nikoli přes addEventListener(). Dialog vyžaduje předchozí vhodnou interakci uživatele (sticky activation); prohlížeč ho může potlačit a sám určuje jeho text. Obsluhu přidávej jen při neuložených změnách a odeber ji po jejich uložení či zahození: může bránit použití bfcache, mimo jiné ve Firefoxu.

pagehide a pageshow jsou nezrušitelné události typu PageTransitionEvent na window. Při opuštění stránky znamená pagehide s event.persisted === true, že prohlížeč hodlá ponechat dokument v paměti pro navigaci zpět či vpřed (bfcache), nikoli že ho určitě obnoví. false znamená, že ho uchovat nehodlá. Používej pagehide k pozastavení práce se zdroji, nikoli k ukládání kritických dat: tato událost i beforeunload mohou chybět, například když mobilní operační systém ukončí prohlížeč na pozadí.

Při prvním načtení nastane pageshow po load s persisted === false. Hodnota true znamená, že byl tentýž dokument skutečně obnoven z bfcache: pokračuj v pozastavené práci a aktualizuj případně zastaralá data. pageshow neznamená, že uživatel stránku vidí; událost může nastat i na kartě na pozadí.

Příklady

<!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>

Výsledek

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.

Otevři příklad jako stránku HTML v prohlížeči a podívej se do konzole. `ready` se vypíše hned; další řádky závisejí na tvých akcích a prohlížeči. Zaškrtávací políčko simuluje neuložené změny, ale nic neukládá.

Související lekce

  • JavaScript · Lekce 35 · Pokročilá · Verze: 4

Zdroje