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

Описание

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

Разрешения

idle

Вы должны объявить разрешение "idle" в манифесте вашего расширения, чтобы использовать API-интерфейс простоя. Например: 

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

Типы

IdleState

Хром 44+

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

"активный"

"праздный"

"заперт"

Методы

getAutoLockDelay()

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

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

Параметры

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

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

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

    (delay: number) => void

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

      число

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

Возврат

  • Обещание<число>

    Хром 116+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

queryState()

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

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

Параметры

  • обнаружениеИнтервалИнСекундс

    число

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

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

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

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

    (newState: IdleState) => void

Возврат

  • Обещание <IdleState>

    Хром 116+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

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

Параметры

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

    число

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

События

onStateChanged

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

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

Параметры

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

    функция

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

    (newState: IdleState) => void