Descrizione
Usa l'API chrome.idle per rilevare quando cambia lo stato di inattività della macchina.
Autorizzazioni
idleManifest
Devi dichiarare lo stato "inattivo" nel file manifest dell'estensione per usare l'API inattiva. Ad esempio:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
Tipi
IdleState
Enum
"attivo"
"inattivo"
"bloccata"
Metodi
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
Recupera il tempo, in secondi, necessario affinché lo schermo si blocchi automaticamente quando è inattivo. Restituisce una durata pari a zero se lo schermo non viene mai bloccato automaticamente. Funzionalità attualmente supportata solo su ChromeOS.
Parametri
-
callback
funzione facoltativa
Il parametro
callbackha il seguente aspetto:(delay: number) => void
-
delay
numero
Tempo, in secondi, fino al blocco automatico dello schermo quando è inattivo. Questo valore è pari a zero se lo schermo non si blocca mai automaticamente.
-
Resi
-
Promise<number>
Chrome 116 e versioni successive .Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
Restituisce "bloccato" Se il sistema è bloccato, "inattivo" se l'utente non ha generato input per un determinato numero di secondi oppure è "attivo" negli altri casi.
Parametri
-
detectionIntervalInSeconds
numero
Il sistema viene considerato inattivo se detectionIntervalInSeconds secondi sono trascorsi dall'ultimo input utente rilevato.
-
callback
funzione facoltativa
Il parametro
callbackha il seguente aspetto:(newState: IdleState) => void
-
newState
-
Resi
-
Promise<IdleState>
Chrome 116 e versioni successive .Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
Imposta l'intervallo, in secondi, utilizzato per determinare quando il sistema è in stato di inattività per gli eventi onStateChanged. L'intervallo predefinito è 60 secondi.
Parametri
-
intervalInSeconds
numero
Soglia, in secondi, utilizzata per determinare quando il sistema è in stato di inattività.
Eventi
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
Attivato quando il sistema passa allo stato attivo, inattivo o bloccato. L'evento si attiva con lo stato "bloccato" Se lo schermo è bloccato o il salvaschermo si attiva, "inattivo" se il sistema è sbloccato e l'utente non ha generato input per un determinato numero di secondi e se è "attivo" quando l'utente genera input su un sistema inattivo.