browser.idle

Описание

Используйте API chrome.idle, чтобы определять, когда меняется состояние бездействия компьютера.

Разрешения

idle

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

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

Типы

IdleState

Chrome 44+ browser.* начиная с Chrome 148

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

"active"

"idle"

"locked"

Методы

getAutoLockDelay()

Chrome 73 и более поздних версий browser.* начиная с Chrome 148 Только для ChromeOS

browser.idle.getAutoLockDelay(): Promise<number>

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

Возвраты

• Promise<number>

  Chrome 116+ browser.* начиная с Chrome 148

queryState()

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

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

Параметры

• detectionIntervalInSeconds

  число

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

Возвраты

• Promise<IdleState>

  Chrome 116+ browser.* начиная с Chrome 148

setDetectionInterval()

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

Задает интервал в секундах, который используется для определения того, когда система находится в режиме ожидания для событий onStateChanged. По умолчанию интервал составляет 60 секунд.

Параметры

• intervalInSeconds

  число

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

События

onStateChanged

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

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

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

  (newState: IdleState) => void

  • newState

    IdleState