CKTIS / JavaScript
Document.hidden — consultar a visibilidade do documento
Document.hidden é uma propriedade só de leitura que indica se o navegador considera o documento oculto. Acompanhe as alterações através de visibilitychange.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
document.hiddenDocument.hidden, lido como document.hidden, devolve true quando document.visibilityState === "hidden"; caso contrário, devolve false. Lê-lo não oculta a página.
O navegador determina a visibilidade, tendo em conta, entre outras circunstâncias, se um separador está em segundo plano ou se uma janela está minimizada. Não confundas esta propriedade com HTMLElement.hidden, que controla o estado oculto de um elemento.
Escuta visibilitychange em document e volta a ler a propriedade. O exemplo apresenta o estado de visibilidade inicial da página atual no parágrafo status e atualiza esse parágrafo sempre que a visibilidade muda. Na consola, regista apenas o valor de hidden do documento criado separadamente, sem ligação à página atual. Esta é uma API Web especificada em HTML Standard, não uma funcionalidade de ECMAScript; a presença de Node 24 não comprova a sua disponibilidade.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.