Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła