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.hiddenDocument.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.