Descrizione
Usa l'API chrome.idle
per rilevare quando lo stato di inattività della macchina cambia.
Autorizzazioni
idle
Per usare l'API inattiva, devi dichiarare l'autorizzazione "idle"
nel manifest dell'estensione. Ad
esempio:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
Tipi
IdleState
Enum
Metodi
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
Riconosce il tempo, in secondi, che occorre prima che lo schermo si blocchi automaticamente quando è inattivo. Restituisce una durata pari a zero se lo schermo non viene mai bloccato automaticamente. Attualmente supportato solo su ChromeOS.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(delay: number) => void
-
delay
numero
Tempo, in secondi, prima che lo schermo venga bloccato automaticamente quando non è attivo. Questo valore è pari a zero se lo schermo non si blocca mai automaticamente.
-
Ritorni
-
Promessa<numero>
Chrome 116 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso 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 numero di secondi specificato o "attivo" in caso contrario.
Parametri
-
detectionIntervalInSeconds
numero
Il sistema viene considerato inattivo se detectionIntervalInSECONDS secondi sono trascorsi dal rilevamento dell'ultimo input utente.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(newState: IdleState) => void
-
newState
-
Ritorni
-
Promise<IdleState>
Chrome 116 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso 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 inattivo.
Eventi
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
Attivato quando il sistema passa a uno stato attivo, inattivo o bloccato. L'evento viene attivato con "bloccato" se lo schermo è bloccato o il salvaschermo si attiva, "inattivo" se il sistema è sbloccato e l'utente non ha generato alcun input per un numero specificato di secondi e "attivo" quando l'utente genera input su un sistema inattivo.