Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Ciclo di vita della pagina: visibilità, uscita e ritorno

Distingui una scheda nascosta, un tentativo di lasciare la pagina e un ripristino dalla cache di navigazione, per salvare, avvisare o riprendere il lavoro al momento giusto.

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

Sintassi

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.

Questi quattro eventi appartengono alla piattaforma web, non a ECMAScript 2024. Supporto e comportamento variano in base al browser e alla situazione. Non dare per scontato che si verifichino tutti in un ordine fisso.

Ascolta visibilitychange su document. L’evento non è annullabile. Leggi document.visibilityState (visible o hidden) oppure il booleano document.hidden. Cambiare scheda può nascondere la pagina senza lasciarla. Salva lo stato man mano e usa il passaggio a hidden come miglior segnale per un ultimo salvataggio o per mettere in pausa il lavoro, non come prova che la sessione sia terminata.

Su window, beforeunload è un BeforeUnloadEvent annullabile, associato al tentativo di lasciare, ricaricare o chiudere la pagina. Per chiedere conferma, chiama event.preventDefault() e imposta event.returnValue su una stringa non vuota per la compatibilità con i browser meno recenti. Restituire un valore dal gestore funziona solo con onbeforeunload, non con addEventListener(). La finestra di conferma richiede un’interazione precedente idonea da parte dell’utente (sticky activation); il browser può non mostrarla e ne decide il testo. Registra il listener solo finché ci sono modifiche non salvate e rimuovilo dopo averle salvate o scartate: può impedire l’uso della bfcache, anche in Firefox.

pagehide e pageshow sono eventi PageTransitionEvent non annullabili su window. All’uscita, pagehide con event.persisted === true indica che il browser intende conservare il documento in memoria per la navigazione indietro/avanti (bfcache), non che verrà ripristinato. false indica che non intende conservarlo. Usa pagehide per sospendere le risorse, non per salvare dati critici: sia questo evento sia beforeunload possono mancare, ad esempio se il sistema operativo mobile termina il browser in background.

Al primo caricamento, pageshow segue load e ha persisted === false. Il valore true indica che lo stesso documento è stato effettivamente ripristinato dalla bfcache: riprendi le attività sospese e aggiorna i dati che potrebbero essere obsoleti. pageshow non implica che l’utente veda la pagina; può anche verificarsi in una scheda in background.

Esempi

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

Risultato

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.

Apri l’esempio come pagina HTML nel browser e controlla la console. `ready` appare subito; i messaggi successivi dipendono dalle tue azioni e dal browser. La casella simula modifiche non salvate, ma non salva nulla.

Lezioni correlate

  • JavaScript · Lezione 35 · Avanzato · Versione: 4

Fonti