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

дата обновления: 2026-09-25 robots: noindex

Описание

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

Разрешения

idle

Манифест

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

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

Типы

IdleState

Chrome 44+

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

"активный"

"праздный"

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

Методы

getAutoLockDelay()

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

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

Параметры

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

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

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

    (delay: number) => void

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

      число

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

Возвраты

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

    Chrome 116+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

queryState()

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

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

Параметры

  • detectionIntervalInSeconds

    число

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

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

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

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

    (newState: IdleState) => void

Возвраты

  • Promise< IdleState >

    Chrome 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