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

CKTIS / JavaScript

visibilitychange — промени във видимостта на документа

Събитието visibilitychange съобщава за промяна във видимостта на документа. Можете да прочетете текущото състояние чрез document.visibilityState.

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

Синтаксис

document.addEventListener("visibilitychange", handler);

visibilitychange е събитие на document, което се задейства след промяна на неговото състояние на видимост. document.visibilityState връща "visible" или "hidden"; document.hidden е булевият еквивалент на втората стойност.

Видимостта се определя от браузъра, например при преминаване към друг раздел или минимизиране на прозорец. Събитието се разпространява нагоре. Можете да го използвате, за да намалите ненужната работа на скрита страница.

Примерът задейства едно синтетично събитие visibilitychange чрез dispatchEvent, без превключване между раздели или промяна във видимостта на документа. Функцията за обработка на събитието се изпълнява само веднъж, защото е регистрирана с once: true. Тя отбелязва събитието в конзолата като synthetic и извежда булевия резултат (true) от проверката дали document.visibilityState има стойност "visible" или "hidden", а не самото състояние на видимост.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Testing a visibilitychange listener</title>
</head>
<body>
<script>
  document.addEventListener('visibilitychange', (event) => {
    // In normal use, read the current state when the browser fires this event.
    const state = document.visibilityState;
    const valid = state === 'visible' || state === 'hidden';
    console.log(`${event.type} (${event.isTrusted ? 'browser' : 'synthetic'}): valid visibilityState = ${valid}`);
  }, { once: true });

  // Exercise the listener without switching tabs or changing visibility.
  document.dispatchEvent(new Event('visibilitychange'));
</script>
</body>
</html>

Резултат

visibilitychange (synthetic): valid visibilityState = true

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

Източници