Descrizione
Usa l'API chrome.idle
per rilevare quando lo stato di inattività della macchina cambia.
Autorizzazioni
idle
Manifest
Per usare l'API inattiva, devi dichiarare l'autorizzazione "inattiva" 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 solo per Manifest V3 e versioni successive; 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 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 solo per Manifest V3 e versioni successive; 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 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.