CKTIS / JavaScript
Document.hidden — odczyt widoczności dokumentu
Document.hidden to właściwość tylko do odczytu, która wskazuje, czy przeglądarka uznaje dokument za ukryty. Zmiany można śledzić przez visibilitychange.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
document.hiddenDocument.hidden, odczytywane jako document.hidden, zwraca true, gdy document.visibilityState === "hidden"; w przeciwnym razie zwraca false. Odczyt nie ukrywa strony.
Przeglądarka określa widoczność, uwzględniając między innymi kartę w tle lub zminimalizowane okno. Nie myl tej właściwości z HTMLElement.hidden, które steruje ukryciem elementu.
Nasłuchuj visibilitychange na document i odczytuj właściwość ponownie. Przykład wyświetla początkowy stan widoczności bieżącej strony w akapicie status i aktualizuje ten akapit po każdej zmianie widoczności. Do konsoli trafia tylko wartość hidden dokumentu utworzonego osobno, bez powiązania z bieżącą stroną. To interfejs Web API opisany w HTML Standard, nie funkcja ECMAScript; obecność Node 24 nie potwierdza jego dostępności.
Przykłady
<!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>Wynik
Detached document.hidden: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.