Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes