chrome.idle

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan chrome.idle API untuk mendeteksi kapan status tidak ada aktivitas mesin berubah.

Izin

idle

Manifes

Anda harus mendeklarasikan izin "idle" dalam manifes ekstensi untuk menggunakan API idle. Contoh:

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

Jenis

IdleState

Chrome 44+

Enum

"active"

"idle"

"locked"

Metode

getAutoLockDelay()

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

Mendapatkan waktu, dalam detik, yang diperlukan hingga layar terkunci secara otomatis saat tidak ada aktivitas. Menampilkan durasi nol jika layar tidak pernah dikunci secara otomatis. Saat ini hanya didukung di ChromeOS.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (delay: number) => void

    • penundaan

      angka

      Waktu, dalam detik, hingga layar dikunci secara otomatis saat tidak ada aktivitas. Nilainya adalah nol jika layar tidak pernah terkunci secara otomatis.

Hasil

  • Promise<number>

    Chrome 116+

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

queryState()

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

Menampilkan "locked" jika sistem terkunci, "idle" jika pengguna tidak menghasilkan input apa pun selama jumlah detik yang ditentukan, atau "active" jika tidak.

Parameter

  • detectionIntervalInSeconds

    angka

    Sistem dianggap tidak ada aktivitas jika detectionIntervalInSeconds detik telah berlalu sejak input pengguna terakhir terdeteksi.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (newState: IdleState) => void

Hasil

  • Promise<IdleState>

    Chrome 116+

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setDetectionInterval()

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

Menetapkan interval, dalam detik, yang digunakan untuk menentukan kapan sistem berada dalam status tidak ada aktivitas untuk peristiwa onStateChanged. Interval default-nya adalah 60 detik.

Parameter

  • intervalInSeconds

    angka

    Batas, dalam detik, yang digunakan untuk menentukan kapan sistem berada dalam status tidak ada aktivitas.

Acara

onStateChanged

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

Diaktifkan saat sistem berubah menjadi status aktif, tidak ada aktivitas, atau terkunci. Peristiwa diaktifkan dengan "locked" jika layar terkunci atau screensaver diaktifkan, "idle" jika sistem tidak terkunci dan pengguna tidak menghasilkan input apa pun selama jumlah detik yang ditentukan, dan "active" saat pengguna menghasilkan input pada sistem yang tidak ada aktivitas.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (newState: IdleState) => void