chrome.idle

Deskripsi

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

Izin

idle

Manifes

Anda harus mendeklarasikan izin "idle" di manifes ekstensi untuk menggunakan idle API. 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 dikunci 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. Nilai ini adalah nol jika layar tidak pernah dikunci secara otomatis.

Hasil

  • Promise<number>

    Chrome 116+

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

queryState()

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

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

Parameter

  • detectionIntervalInSeconds

    angka

    Sistem dianggap tidak aktif 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 Manifest 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 dalam status tidak aktif untuk peristiwa onStateChanged. Interval default adalah 60 detik.

Parameter

  • intervalInSeconds

    angka

    Nilai minimum, 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 ke status aktif, tidak ada aktivitas, atau terkunci. Peristiwa ini diaktifkan dengan "locked" jika layar dikunci atau screensaver diaktifkan, "idle" jika sistem tidak dikunci dan pengguna tidak menghasilkan input apa pun selama beberapa detik yang ditentukan, dan "active" saat pengguna menghasilkan input pada sistem yang tidak aktif.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (newState: IdleState) => void