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