chrome.idle

refresh date: 2026-09-25 robots: noindex

Açıklama

Makinenin boşta kalma durumu değiştiğinde bunu 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 beyan etmeniz gerekir. Örneğin:

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

Türler

IdleState

Chrome 44 ve sonraki sürümler

Enum

"active"

"idle"

"locked"

Yöntemler

getAutoLockDelay()

Promise Chrome 73 ve sonraki sürümler Yalnızca ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

Boşta kalma durumunda ekranın otomatik olarak kilitlenmesi için geçen süreyi saniye cinsinden alır. Ekran hiçbir zaman otomatik olarak kilitlenmezse sıfır süre döndürür. Şu anda yalnızca ChromeOS'te desteklenmektedir.

Parametreler

  • callback

    işlev isteğe bağlı

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

    (delay: number) => void

    • gecikme

      sayı

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

İadeler

  • Promise<number>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

queryState()

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

Sistem kilitliyse "locked", kullanıcı belirli bir süre boyunca herhangi bir giriş yapmadı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

    işlev isteğe bağlı

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

    (newState: IdleState) => void

İadeler

  • Promise<IdleState>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setDetectionInterval()

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

Sistemin onStateChanged etkinlikleri için 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 eşik (saniye cinsinden).

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ştirilmişse etkinlik "locked" (kilitli), sistemin kilidi açılmışsa ve kullanıcı belirli bir süre boyunca herhangi bir giriş yapmamışsa "idle" (boşta), kullanıcı boşta olan bir sistemde giriş yaptığında ise "active" (etkin) değeriyle tetiklenir.

Parametreler

  • callback

    işlev

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

    (newState: IdleState) => void