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 dan yang lebih baru

Enum

"aktif"

"tidak ada aktivitas"

"terkunci"

Metode

getAutoLockDelay()

Janji Chrome 73 dan yang lebih baru 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 terkunci secara otomatis. Saat ini hanya didukung di ChromeOS.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (delay: number) => void

    • penundaan

      angka

      Waktu, dalam detik, hingga layar terkunci otomatis saat tidak ada aktivitas. Nilai ini 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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

queryState()

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

Menampilkan "terkunci" jika sistem dikunci, "tidak ada aktivitas" jika pengguna tidak menghasilkan input apa pun selama sekian detik yang ditentukan, atau "aktif" sebaliknya.

Parameter

  • detectionIntervalInSeconds

    angka

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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (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. Tujuan promise yang di-resolve dengan jenis yang sama dengan 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 onStateChanges. Interval default adalah 60 detik.

Parameter

  • intervalInSeconds

    angka

    Nilai minimum, dalam detik, digunakan untuk menentukan kapan sistem 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 dipicu dengan status "terkunci" jika layar terkunci atau screensaver diaktifkan, "tidak ada aktivitas" jika sistem dibuka dan pengguna tidak menghasilkan input apa pun selama jumlah detik tertentu, dan "aktif" saat pengguna membuat input pada sistem yang tidak ada aktivitas.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (newState: IdleState) => void