Descrizione
Usa l'API chrome.idle per rilevare quando cambia lo stato di inattività della macchina.
Autorizzazioni
idlePer usare l'API inattiva, devi dichiarare l'autorizzazione "idle" nel file manifest dell'estensione. 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 in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al 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 in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al 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.