CKTIS / JavaScript
visibilitychange — cambios en la visibilidad del documento
El evento visibilitychange informa de un cambio en la visibilidad del documento. Consulta el estado actual con document.visibilityState.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
document.addEventListener("visibilitychange", handler);visibilitychange es un evento de document que se dispara después de que cambia su estado de visibilidad. document.visibilityState devuelve "visible" o "hidden"; document.hidden es el equivalente booleano del segundo valor.
El navegador determina la visibilidad, por ejemplo, al cambiar de pestaña o minimizar una ventana. El evento se propaga hacia arriba. Puedes usarlo para reducir el trabajo innecesario en una página oculta.
El ejemplo usa dispatchEvent para disparar un único evento sintético visibilitychange, sin cambiar de pestaña ni modificar la visibilidad del documento. El manejador se ejecuta una sola vez porque se registra con once: true. En la consola identifica el evento como synthetic y muestra el resultado booleano (true) de comprobar si document.visibilityState vale "visible" o "hidden", no el estado de visibilidad en sí.
Ejemplos
<!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>Resultado
visibilitychange (synthetic): valid visibilityState = true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.