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

CKTIS / JavaScript

Document.hidden — consultar la visibilidad del documento

Document.hidden es una propiedad de solo lectura que indica si el navegador considera que el documento está oculto. Puedes seguir los cambios con visibilitychange.

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.hidden

Document.hidden, leído como document.hidden, devuelve true cuando document.visibilityState === "hidden"; en caso contrario, devuelve false. Leerlo no oculta la página.

El navegador determina la visibilidad teniendo en cuenta, entre otras circunstancias, si una pestaña está en segundo plano o una ventana está minimizada. No confundas esta propiedad con HTMLElement.hidden, que controla el estado oculto de un elemento.

Escucha visibilitychange en document y vuelve a leer la propiedad. El ejemplo muestra el estado de visibilidad inicial de la página actual en el párrafo status y actualiza ese párrafo cada vez que cambia la visibilidad. En la consola solo se registra el valor de hidden del documento creado por separado, sin vincularlo a la página actual. Esta es una API web especificada en HTML Standard, no una característica de ECMAScript; disponer de Node 24 no demuestra que esté disponible.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.hidden</title>
</head>
<body>
  <h1>Document visibility</h1>
  <p id="status" role="status"></p>
  <script>
    const detached = document.implementation.createHTMLDocument('Detached example');
    console.log('Detached document.hidden: ' + detached.hidden);

    const status = document.getElementById('status');
    function showVisibility() {
      status.textContent = document.hidden ? 'This page is hidden.' : 'This page is visible.';
    }
    document.addEventListener('visibilitychange', showVisibility);
    showVisibility();
  </script>
</body>
</html>

Resultado

Detached document.hidden: 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