IdleDetector

Интерфейс IdleDetector API обнаружения бездействия предоставляет методы и события для обнаружения активности пользователя на устройстве или экране.

Этот интерфейс требует безопасного контекста.

IdleDetector() Экспериментальная

Создаёт новый объект IdleDetector.

IdleDetector.userState Только чтение Экспериментальная

Возвращает строку, указывающую, взаимодействовал ли пользователь с экраном или устройством в течение порога, заданного для start(), одного из "active" или "idle". Это свойство возвращает null до вызова start().

IdleDetector.screenState Только чтение Экспериментальная

Возвращает строку, указывающую, заблокирован ли экран, одно из "locked" или "unlocked". Это свойство возвращает null до вызова start().

change Экспериментальная

Вызывается при изменении значения userState или screenState.

IdleDetector.requestPermission() Экспериментальная

Возвращает Promise, который разрешается, когда пользователь выбрал, предоставить ли источнику доступ к своему состоянию бездействия. Разрешается с "granted" при принятии и "denied" при отклонении.

IdleDetector.start() Экспериментальная

Возвращает Promise, который разрешается при запуске детектирования изменений состояния бездействия пользователя. userState и screenState получают начальные значения. Этот метод принимает необъект options с threshold в миллисекундах, когда должно быть сообщено о бездействии, и signal для AbortSignal отмены детектора бездействия.

В следующем примере показано создание детектора и регистрация изменений состояния бездействия пользователя. Используется кнопка для получения необходимой активации пользователя перед запросом разрешения.

const controller = new AbortController();
const signal = controller.signal;

startButton.addEventListener("click", async () => {
  if ((await IdleDetector.requestPermission()) !== "granted") {
    console.error("Idle detection permission denied.");
    return;
  }

  try {
    const idleDetector = new IdleDetector();
    idleDetector.addEventListener("change", () => {
      const userState = idleDetector.userState;
      const screenState = idleDetector.screenState;
      console.log(`Idle change: ${userState}, ${screenState}.`);
    });

    await idleDetector.start({
      threshold: 60_000,
      signal,
    });
    console.log("IdleDetector is active.");
  } catch (err) {
    // Deal with initialization errors like permission denied,
    // running outside of top-level frame, etc.
    console.error(err.name, err.message);
  }
});

stopButton.addEventListener("click", () => {
  controller.abort();
  console.log("IdleDetector is stopped.");
});