CKTIS / JavaScript
Visibilità del documento: `Document.hidden` e `visibilitychange`
Leggi la visibilità corrente del documento con `document.hidden` e reagisci ai cambiamenti con `visibilitychange`, senza controlli periodici.
Versione: Current web platform; runtime support varies
Sintassi
document.hidden
document.visibilityState
document.addEventListener("visibilitychange", listener)
document.removeEventListener("visibilitychange", listener)document.hidden è una proprietà booleana di sola lettura. Vale true quando document.visibilityState è "hidden" e false quando è "visible". Una scheda in secondo piano o una finestra ridotta a icona sono casi comuni in cui il documento risulta nascosto. Lo stato non dice se la pagina ha il focus, se un determinato elemento è visibile o se qualcuno sta guardando la pagina.
Il browser genera visibilitychange su document dopo un cambio di stato in una delle due direzioni. È un semplice Event che si propaga verso l’alto e non è annullabile. Non contiene il nuovo stato: leggi la proprietà all’interno del listener. Registrare il listener non lo richiama subito, quindi leggi lo stato iniziale a parte. Per rimuoverlo, passa la stessa funzione a removeEventListener.
Puoi, per esempio, sospendere gli aggiornamenti non necessari dell’interfaccia mentre il documento è nascosto e riprenderli quando torna visibile. Il passaggio a "hidden" non significa che la pagina sia stata chiusa, né puoi contare sul fatto che il browser dia al codice il tempo di terminare il lavoro. Questa API fa parte della piattaforma web, non di ECMAScript. La sua disponibilità dipende dall’ambiente di esecuzione.
Esempi
const stopVisibilityLog = (() => {
const hasDocument = typeof document !== "undefined";
const page = hasDocument ? document : new EventTarget();
let simulatedHidden = false;
if (!hasDocument) {
// Node.js fixture: simulate visibility without a browser document.
Object.defineProperty(page, "hidden", { get: () => simulatedHidden });
}
const logVisibility = () => {
console.log(page.hidden ? "hidden" : "visible");
};
page.addEventListener("visibilitychange", logVisibility);
logVisibility();
const stop = () => {
page.removeEventListener("visibilitychange", logVisibility);
};
if (!hasDocument) {
const changeVisibility = (hidden) => {
simulatedHidden = hidden;
page.dispatchEvent(new Event("visibilitychange", { bubbles: true }));
};
changeVisibility(true);
changeVisibility(false);
stop();
changeVisibility(true); // No log after removing the listener.
}
return stop;
})();Risultato
visible hidden visible
Esegui il codice una volta nella console del browser per una pagina visibile. Passa a un’altra scheda e poi torna alla prima. L’output mostrato presuppone esattamente questi due cambiamenti dopo la lettura iniziale. Chiama `stopVisibilityLog()` per interrompere la registrazione. In Node.js, l’esempio simula i cambiamenti di visibilità senza usare un documento del browser.
Lezioni correlate
- JavaScript · Lezione 27 · Intermedio · Versione: 3
- JavaScript · Lezione 29 · Intermedio · Versione: 3
- JavaScript · Lezione 31 · Intermedio · Versione: 3