CKTIS / JavaScript
visibilitychange — changements de visibilité du document
L’événement visibilitychange signale un changement de visibilité du document. Consultez l’état actuel avec document.visibilityState.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.addEventListener("visibilitychange", handler);visibilitychange est un événement de document, déclenché après un changement de son état de visibilité. document.visibilityState renvoie "visible" ou "hidden" ; document.hidden est l’équivalent booléen de cette seconde valeur.
Le navigateur détermine la visibilité, par exemple lors du passage à un autre onglet ou de la réduction de la fenêtre. L’événement remonte dans l’arborescence. Vous pouvez l’utiliser pour réduire les opérations inutiles sur une page masquée.
L’exemple déclenche un seul événement synthétique visibilitychange avec dispatchEvent, sans changer d’onglet ni modifier la visibilité du document. Le gestionnaire d’événement, enregistré avec once: true, ne s’exécute qu’une fois. Il indique dans la console que l’événement est synthetic et vérifie si document.visibilityState vaut "visible" ou "hidden". Il affiche le résultat booléen (true), et non l’état de visibilité lui-même.
Exemples
<!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>Résultat
visibilitychange (synthetic): valid visibilityState = true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.