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

Описание

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

Разрешения

idle

Манифест

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

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

Типы

IdleState

Хром 44+

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

"активный"

"праздный"

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

Методы

getAutoLockDelay()

Обещаю Chrome 73+ только для ChromeOS
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

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

Параметры

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

    функция необязательна

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

    (delay: number) => void

    • задерживать

      число

      Время (в секундах) до автоматической блокировки экрана в режиме ожидания. Это время равно нулю, если экран никогда не блокируется автоматически.

Возврат

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

    Хром 116+

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

queryState()

Обещать
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

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

Параметры

  • detectorIntervalInSeconds

    число

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

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

    функция необязательна

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

    (newState: IdleState) => void

Возврат

  • Хром 116+

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

setDetectionInterval()

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

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

Параметры

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

    число

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

События

onStateChanged

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

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

Параметры

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

    функция

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

    (newState: IdleState) => void