Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Document.hidden — leggere la visibilità del documento

Document.hidden è una proprietà di sola lettura che indica se il browser considera nascosto il documento. Per seguire i cambiamenti, usa visibilitychange.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

document.hidden

Document.hidden, letto come document.hidden, restituisce true quando document.visibilityState === "hidden"; altrimenti restituisce false. Leggerlo non nasconde la pagina.

Il browser determina la visibilità tenendo conto, tra le altre cose, di una scheda in background o di una finestra ridotta a icona. Non confondere questa proprietà con HTMLElement.hidden, che controlla lo stato nascosto di un elemento.

Ascolta visibilitychange su document e leggi di nuovo la proprietà. L’esempio mostra lo stato di visibilità iniziale della pagina corrente nel paragrafo status e aggiorna il paragrafo ogni volta che la visibilità cambia. Nella console viene registrato solo il valore di hidden del documento creato separatamente, senza collegarlo alla pagina corrente. Questa è una Web API descritta in HTML Standard, non una funzionalità ECMAScript; la presenza di Node 24 non ne dimostra la disponibilità.

Esempi

<!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>

Risultato

Detached document.hidden: true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti