chrome.idle

refresh date: 2026-09-25 robots: noindex

Açıklama

Makinenin boşta kalma durumunun ne zaman değiştiğini algılamak için chrome.idle API'sini kullanın.

İzinler

idle

Manifest

Idle API'yi kullanmak için uzantınızın manifest dosyasında"idle" iznini belirtmeniz gerekir. Örneğin:

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

Türler

IdleState

Chrome 44+

Enum

"etkin"

"idle"

"locked"

Yöntemler

getAutoLockDelay()

Promise Chrome 73+ Yalnızca ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

Cihaz boştayken ekranın otomatik olarak kilitlenmesi için gereken süreyi saniye cinsinden alır. Ekran hiçbir zaman otomatik olarak kilitlenmiyorsa sıfır süresini döndürür. Şu anda yalnızca ChromeOS'te desteklenmektedir.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (delay: number) => void

    • gecikme

      sayı

      Boşta kaldığında ekranın otomatik olarak kilitlenmesine kadar geçen süre (saniye cinsinden). Ekran hiçbir zaman otomatik olarak kilitlenmiyorsa bu değer sıfırdır.

İadeler

  • Promise<number>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

queryState()

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

Sistem kilitliyse "locked", kullanıcı belirli bir saniye boyunca herhangi bir giriş oluşturmadıysa "idle", aksi takdirde "active" değerini döndürür.

Parametreler

  • detectionIntervalInSeconds

    sayı

    Algılanan son kullanıcı girişinden bu yana detectionIntervalInSeconds saniye geçtiyse sistem boşta kabul edilir.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (newState: IdleState) => void

İadeler

  • Promise<IdleState>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setDetectionInterval()

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

onStateChanged etkinlikleri için sistemin ne zaman boşta olduğunu belirlemek üzere kullanılan aralığı saniye cinsinden ayarlar. Varsayılan aralık 60 saniyedir.

Parametreler

  • intervalInSeconds

    sayı

    Sistemin ne zaman boşta olduğunu belirlemek için kullanılan saniye cinsinden eşik.

Etkinlikler

onStateChanged

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

Sistem etkin, boşta veya kilitli duruma geçtiğinde tetiklenir. Ekran kilitliyse veya ekran koruyucu etkinleşirse etkinlik "kilitli" olarak tetiklenir. Sistem kilitli değilse ve kullanıcı belirli bir saniye boyunca herhangi bir giriş oluşturmadıysa "boşta" olarak tetiklenir. Kullanıcı boşta olan bir sistemde giriş oluşturduğunda ise "etkin" olarak tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (newState: IdleState) => void