chrome.idle

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu API chrome.idle, aby wykrywać zmiany stanu bezczynności komputera.

Uprawnienia

idle

Plik manifestu

Aby korzystać z interfejsu API stanu bezczynności, musisz zadeklarować uprawnienie „idle” w pliku manifestu rozszerzenia. Przykład:

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

Typy

IdleState

Chrome 44 lub nowsza wersja

Typ wyliczeniowy

"active"

"idle"

"locked"

Metody

getAutoLockDelay()

Promise Chrome 73 lub nowsza wersja Tylko ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

Pobiera czas (w sekundach), po którym ekran jest automatycznie blokowany, gdy urządzenie jest bezczynne. Jeśli ekran nigdy nie jest blokowany automatycznie, zwraca wartość 0. Obecnie obsługiwane tylko w ChromeOS.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (delay: number) => void

    • opóźnienia

      liczba

      Czas (w sekundach), po którym ekran zostanie automatycznie zablokowany, gdy urządzenie będzie bezczynne. Jeśli ekran nigdy nie blokuje się automatycznie, wartość wynosi 0.

Zwroty

  • Promise<number>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

queryState()

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

Zwraca „locked” (zablokowany), jeśli system jest zablokowany, „idle” (bezczynny), jeśli użytkownik nie wygenerował żadnych danych wejściowych przez określoną liczbę sekund, lub „active” (aktywny) w pozostałych przypadkach.

Parametry

  • detectionIntervalInSeconds

    liczba

    System jest uznawany za nieaktywny, jeśli od ostatniego wykrytego działania użytkownika upłynęło detectionIntervalInSeconds sekund.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (newState: IdleState) => void

Zwroty

  • Promise<IdleState>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

setDetectionInterval()

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

Ustawia interwał (w sekundach) używany do określania, kiedy system jest w stanie bezczynności w przypadku zdarzeń onStateChanged. Domyślny interwał to 60 sekund.

Parametry

  • intervalInSeconds

    liczba

    Próg w sekundach używany do określania, kiedy system jest w stanie bezczynności.

Wydarzenia

onStateChanged

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

Uruchamiane, gdy system przechodzi w stan aktywny, bezczynny lub zablokowany. Zdarzenie jest wywoływane z wartością „locked” (zablokowany), jeśli ekran jest zablokowany lub aktywuje się wygaszacz ekranu, „idle” (bezczynny), jeśli system jest odblokowany, a użytkownik nie wygenerował żadnych danych wejściowych przez określoną liczbę sekund, oraz „active” (aktywny), gdy użytkownik generuje dane wejściowe w bezczynnym systemie.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (newState: IdleState) => void