Документ: свойство visibilityState

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Свойство Document.visibilityState только для чтения возвращает видимость документа. Его можно использовать для проверки, находится ли документ в фоновом режиме или в минимизированном окне, или он по другим причинам не виден пользователю.

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

Свойство Document.hidden предоставляет альтернативный способ определения, скрыта ли страница.

Значение

Строка с одним из следующих значений:

visible: Контент страницы может быть хотя бы частично виден. На практике это означает, что страница является активной вкладкой не минимизированного окна.
hidden: Контент страницы не виден пользователю. На практике это означает, что документ является фоновой вкладкой или частью минимизированного окна, или активен экранный блокировщик ОС.

Примеры

document.addEventListener("visibilitychange", () => {
  console.log(document.visibilityState);
  // Modify behavior…
});

Спецификации

Спецификация
HTML # dom-document-visibilitystate

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`visibilityState`	3313	12	1810–52	201512.1–15	7	3318	1810–52	201412.1–14	7	2.01.0	4.4.3≤37

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/visibilityState