chrome.idle

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

idle

Манифест

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

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

Типы

IdleState

Chrome 44 и более поздних версий;

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

"active"

"idle"

"locked"

Методы

getAutoLockDelay()

Promise Chrome 73+ Только для ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

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

Параметры

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

    function необязательно

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

    (delay: number) => void

    • delay

      число

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

Возвраты

  • Promise<number>

    Chrome 116 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

queryState()

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

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

Параметры

  • detectionIntervalInSeconds

    число

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

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

    function необязательно

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

    (newState: IdleState) => void

Возвраты

  • Promise<IdleState>

    Chrome 116 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

setDetectionInterval()

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

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

Параметры

  • intervalInSeconds

    число

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

События

onStateChanged

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

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

Параметры

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

    function

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

    (newState: IdleState) => void