Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Životni ciklus stranice: vidljivost, odlazak i povratak

Razlikuj skrivenu karticu, pokušaj napuštanja stranice i vraćanje iz predmemorije za kretanje natrag i naprijed kako bi na vrijeme spremio stanje, upozorio korisnika ili nastavio rad.

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

Sintaksa

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.

Ova četiri događaja pripadaju web-platformi, a ne ECMAScriptu 2024. Podrška i ponašanje ovise o pregledniku i situaciji. Ne pretpostavljaj da će se svi događaji aktivirati utvrđenim redoslijedom.

Osluškuj visibilitychange na document. Taj se događaj ne može poništiti. Očitaj document.visibilityState (visible ili hidden) ili Booleovu vrijednost document.hidden. Prebacivanje na drugu karticu može sakriti stranicu bez napuštanja. Spremaj stanje tijekom rada, a prijelaz na hidden koristi kao najbolji signal za posljednje spremanje ili pauziranje rada, ne kao dokaz da je sesija završila.

beforeunload na window može se poništiti i ima tip BeforeUnloadEvent. Povezan je s pokušajem napuštanja, ponovnog učitavanja ili zatvaranja stranice. Za potvrdu pozovi event.preventDefault() i radi kompatibilnosti sa starijim preglednicima postavi event.returnValue na neprazan niz znakova. Vraćanje vrijednosti iz funkcije za obradu djeluje samo putem onbeforeunload, ne putem addEventListener(). Dijalog zahtijeva odgovarajuću prethodnu interakciju korisnika (sticky activation); preglednik ga može izostaviti i sam određuje njegov tekst. Dodaj osluškivač samo dok postoje nespremljene izmjene i ukloni ga kad ih spremiš ili odbaciš: može spriječiti korištenje bfcachea, među ostalim u Firefoxu.

pagehide i pageshow na window imaju tip PageTransitionEvent i ne mogu se poništiti. Pri odlasku pagehide s event.persisted === true znači da preglednik namjerava zadržati dokument u memoriji za kretanje natrag i naprijed (bfcache), a ne da će ga sigurno vratiti. false znači da ga ne namjerava zadržati. Koristi pagehide za pauziranje rada s resursima, ne za spremanje ključnih podataka: i taj događaj i beforeunload mogu izostati, primjerice kad mobilni operacijski sustav prekine rad preglednika u pozadini.

Pri prvom učitavanju pageshow slijedi nakon load uz persisted === false. Vrijednost true znači da je isti dokument stvarno vraćen iz bfcachea: nastavi pauzirani rad i osvježi podatke koji su možda zastarjeli. pageshow ne znači da korisnik vidi stranicu; može se aktivirati i u pozadinskoj kartici.

Primjeri

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

Rezultat

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.

Otvori primjer kao HTML stranicu u pregledniku i pogledaj konzolu. `ready` se ispisuje odmah; kasniji ispisi ovise o tvojim radnjama i pregledniku. Potvrdni okvir simulira nespremljene izmjene, ali ništa ne sprema.

Povezane lekcije

  • JavaScript · Lekcija 35 · Napredno · Verzija: 4

Izvori