База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Document.hidden — проверка на видимостта на документа

Document.hidden е свойство само за четене, което показва дали браузърът смята документа за скрит. Проследявайте промените чрез visibilitychange.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

document.hidden

Document.hidden, прочетено като document.hidden, връща true, когато е изпълнено document.visibilityState === "hidden"; в противен случай връща false. Самото прочитане не скрива страницата.

Браузърът определя видимостта, като взема предвид, наред с други обстоятелства, раздел във фонов режим или минимизиран прозорец. Не бъркайте това свойство с HTMLElement.hidden, което управлява скритото състояние на елемент.

Слушайте за visibilitychange върху document и прочетете свойството отново. Примерът показва началното състояние на видимостта на текущата страница в абзаца status и обновява този абзац при всяка промяна на видимостта. В конзолата се извежда само стойността на hidden за отделно създадения документ, който не е свързан с текущата страница. Това е Web API, описано в HTML Standard, а не функция на ECMAScript; наличието на Node 24 не доказва, че API е достъпно.

Примери

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

Резултат

Detached document.hidden: true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници