Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

visibilitychange — cambiamenti della visibilità del documento

L’evento visibilitychange segnala un cambiamento nella visibilità del documento. Puoi leggere lo stato attuale da document.visibilityState.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

document.addEventListener("visibilitychange", handler);

visibilitychange è un evento di document che viene attivato dopo una modifica del suo stato di visibilità. document.visibilityState restituisce "visible" oppure "hidden"; document.hidden è l’equivalente booleano del secondo valore.

È il browser a determinare la visibilità, ad esempio quando si passa a un’altra scheda o si riduce a icona la finestra. L’evento risale la gerarchia. Puoi usarlo per ridurre il lavoro non necessario su una pagina nascosta.

L’esempio usa dispatchEvent per generare un solo evento sintetico visibilitychange, senza cambiare scheda né modificare la visibilità del documento. Il gestore viene eseguito una sola volta perché è registrato con once: true. Nella console identifica l’evento come synthetic e mostra il risultato booleano (true) del controllo che verifica se document.visibilityState vale "visible" o "hidden", non lo stato di visibilità stesso.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Testing a visibilitychange listener</title>
</head>
<body>
<script>
  document.addEventListener('visibilitychange', (event) => {
    // In normal use, read the current state when the browser fires this event.
    const state = document.visibilityState;
    const valid = state === 'visible' || state === 'hidden';
    console.log(`${event.type} (${event.isTrusted ? 'browser' : 'synthetic'}): valid visibilityState = ${valid}`);
  }, { once: true });

  // Exercise the listener without switching tabs or changing visibility.
  document.dispatchEvent(new Event('visibilitychange'));
</script>
</body>
</html>

Risultato

visibilitychange (synthetic): valid visibilityState = true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti