Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes