хром.холостой ход

Описание

Используйте API chrome.idle для определения изменения состояния простоя устройства.

Разрешения

idle

Чтобы использовать API бездействия, необходимо указать разрешение "idle" в манифесте расширения. Например:

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

Типы

IdleState

Хром 44+

Перечисление

"активный"

"праздный"

"заблокирован"

Методы

getAutoLockDelay()

Только Chrome OS 73+
chrome.idle.getAutoLockDelay(): Promise<number>

Возвращает время (в секундах), необходимое для автоматической блокировки экрана в режиме бездействия. Возвращает нулевое значение, если экран никогда не блокируется автоматически. В настоящее время поддерживается только в Chrome OS.

Возврат

  • Обещание<номер>

    Хром 116+

queryState()

chrome.idle.queryState(
  detectionIntervalInSeconds: number,
): Promise<IdleState>

Возвращает значение «locked», если система заблокирована, «idle», если пользователь не вносил никаких изменений в течение указанного количества секунд, или «active» в противном случае.

Параметры

  • detectorIntervalInSeconds

    число

    Система считается бездействующей, если с момента последнего обнаруженного пользовательского ввода прошло detectIntervalInSeconds секунд.

Возврат

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

Задаёт интервал (в секундах), используемый для определения состояния бездействия системы для событий onStateChanged. Интервал по умолчанию — 60 секунд.

Параметры

  • интервалВСекундах

    число

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

События

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

Срабатывает, когда система переходит в активное, бездействующее или заблокированное состояние. Событие срабатывает со статусом «locked», если экран заблокирован или активирована заставка, со статусом «idle», если система разблокирована и пользователь не совершал никаких действий в течение указанного количества секунд, и со статусом «active», когда пользователь совершает действия в бездействующей системе.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (newState: IdleState) => void