API для определения простоя

API для определения простоя предоставляет возможность определять состояние активности пользователя, активный, неактивный и заблокированный, а также получать уведомления об изменениях состояния простоя без опроса со стороны скрипта.

Нативные приложения и расширения браузера используют определение простоя, основываясь на взаимодействии пользователя с устройством. Например, приложения чата могут показывать другим пользователям, доступен ли кто-то. Другие приложения могут выбирать показывать уведомления только при взаимодействии пользователя с приложением. Веб-приложение может использовать этот API для аналогичных случаев. Кроме того, прогрессивное веб-приложение может использовать определение простоя для запуска обновления сервисного работника, когда приложение не используется.

IdleDetector Экспериментально

Предоставляет методы и события для определения активности пользователя на устройстве или экране.

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

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.");
});