Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Životný cyklus stránky: viditeľnosť, opustenie a návrat

Rozlíš skrytie karty, pokus o opustenie stránky a obnovenie z vyrovnávacej pamäte pri navigácii späť alebo dopredu, aby si v správnej chvíli ukladal stav, varoval alebo pokračoval v práci.

Verzia: 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.

Tieto štyri udalosti patria k webovej platforme, nie k ECMAScriptu 2024. Podpora a správanie závisia od prehliadača a situácie. Nespoliehaj sa, že všetky udalosti nastanú v pevnom poradí.

Počúvaj visibilitychange na document. Túto udalosť nemožno zrušiť. Prečítaj document.visibilityState (visible alebo hidden) alebo logickú hodnotu document.hidden. Prepnutie karty môže skryť stránku bez jej opustenia. Ukladaj stav priebežne a prechod na hidden ber ako najlepší signál na posledné uloženie alebo pozastavenie práce, nie ako dôkaz skončenia relácie.

beforeunload na window je zrušiteľná udalosť typu BeforeUnloadEvent spojená s pokusom opustiť, znova načítať alebo zavrieť stránku. Ak chceš požiadať o potvrdenie, zavolaj event.preventDefault() a kvôli kompatibilite so staršími prehliadačmi nastav event.returnValue na neprázdny reťazec. Vrátenie hodnoty z obslužnej funkcie funguje len cez onbeforeunload, nie cez addEventListener(). Dialóg vyžaduje predchádzajúcu vhodnú interakciu používateľa (sticky activation); prehliadač ho môže potlačiť a určuje jeho text. Obsluhu pridaj len pri neuložených zmenách a odstráň ju po ich uložení alebo zahodení: jej prítomnosť môže zabrániť použitiu bfcache, okrem iného vo Firefoxe.

pagehide a pageshow sú nezrušiteľné udalosti typu PageTransitionEvent na window. Pri opustení stránky znamená pagehide s event.persisted === true, že prehliadač chce uchovať dokument v pamäti na navigáciu späť alebo dopredu (bfcache), nie že ho určite obnoví. false znamená, že ho uchovať nechce. Používaj pagehide na pozastavenie práce so zdrojmi, nie na ukladanie kritických údajov: táto udalosť aj beforeunload nemusia nastať, napríklad keď mobilný operačný systém ukončí prehliadač na pozadí.

Pri prvom načítaní nasleduje pageshow po load s persisted === false. Hodnota true znamená, že ten istý dokument bol skutočne obnovený z bfcache: pokračuj v pozastavenej práci a aktualizuj prípadne neaktuálne údaje. pageshow neznamená, že používateľ stránku vidí; môže nastať aj na karte na pozadí.

Prí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ýsledok

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.

Otvor príklad ako stránku HTML v prehliadači a pozri sa do konzoly. `ready` sa zobrazí hneď; ďalšie výpisy závisia od tvojich akcií a prehliadača. Začiarkavacie políčko simuluje neuložené zmeny, ale nič neukladá.

Súvisiace lekcie

  • JavaScript · Lekcia 35 · Pokročilá · Verzia: 4

Zdroje