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