browser.idle

Descrizione

Utilizza l'API chrome.idle per rilevare quando cambia lo stato di inattività della macchina.

Autorizzazioni

idle

Per utilizzare l'API Idle, devi dichiarare l'autorizzazione "idle" nel file manifest dell'estensione. Ad esempio:

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

Tipi

IdleState

Browser Chrome 44 e versioni successive * da Chrome 148

Enum

"active"

"idle"

"locked"

Metodi

getAutoLockDelay()

Chrome 73 e versioni successive browser.* da Chrome 148 Solo ChromeOS
browser.idle.getAutoLockDelay(): Promise<number>

Restituisce il tempo, in secondi, necessario per il blocco automatico dello schermo quando il dispositivo è inattivo. Restituisce una durata pari a zero se lo schermo non viene mai bloccato automaticamente. Al momento è supportata solo su ChromeOS.

Resi

  • Promise<number>

    Chrome 116+ browser.* da Chrome 148

queryState()

browser.idle.queryState(
  detectionIntervalInSeconds: number,
)
: Promise<IdleState>

Restituisce "locked" se il sistema è bloccato, "idle" se l'utente non ha generato alcun input per un numero di secondi specificato o "active" in caso contrario.

Parametri

  • detectionIntervalInSeconds

    numero

    Il sistema viene considerato inattivo se sono trascorsi detectionIntervalInSeconds secondi dall'ultimo input utente rilevato.

Resi

  • Promise<IdleState>

    Chrome 116+ browser.* da Chrome 148

setDetectionInterval()

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

Imposta l'intervallo, in secondi, utilizzato per determinare quando il sistema è in stato di inattività per gli eventi onStateChanged. L'intervallo predefinito è di 60 secondi.

Parametri

  • intervalInSeconds

    numero

    Soglia, in secondi, utilizzata per determinare quando il sistema è in stato di inattività.

Eventi

onStateChanged

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

Attivato quando il sistema passa a uno stato attivo, inattivo o bloccato. L'evento viene attivato con "locked" se lo schermo è bloccato o se si attiva il salvaschermo, "idle" se il sistema è sbloccato e l'utente non ha generato alcun input per un numero di secondi specificato e "active" quando l'utente genera un input su un sistema inattivo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (newState: IdleState) => void