chrome.idle

Deskripsi

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

Izin

idle

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

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

Jenis

IdleState

Chrome 44+

Enum

Metode

getAutoLockDelay()

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

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

    • delay

      angka

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

Hasil

  • Promise<number>

    Chrome 116 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

queryState()

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

Menampilkan "terkunci" jika sistem terkunci, "tidak ada aktivitas" jika pengguna tidak menghasilkan input apa pun selama jumlah detik tertentu, atau "aktif" jika tidak.

Parameter

  • detectionIntervalInSeconds

    angka

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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (newState: IdleState)=>void

Hasil

  • Promise<IdleState>

    Chrome 116 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

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

Parameter

  • intervalInSeconds

    angka

    Ambang batas, dalam detik, digunakan untuk menentukan kapan sistem dalam status tidak ada aktivitas.

Peristiwa

onStateChanged

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (newState: IdleState)=>void