refresh date: 2026-09-25 robots: noindex
Descrizione
Utilizza l'API chrome.idle per rilevare quando cambia lo stato di inattività della macchina.
Autorizzazioni
idleManifest
Per utilizzare l'API idle, devi dichiarare l'autorizzazione "idle" nel file manifest dell'estensione. Ad esempio:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
Tipi
IdleState
Enum
"active"
"idle"
"locked"
Metodi
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
): 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.
Parametri
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:(delay: number) => void
-
delay
numero
Tempo, in secondi, prima che lo schermo venga bloccato automaticamente quando è inattivo. Il valore è zero se lo schermo non si blocca mai automaticamente.
-
Resi
-
Promise<number>
Chrome 116 e versioni successiveLe promise 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,
): 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.
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:(newState: IdleState) => void
-
newState
-
Resi
-
Promise<IdleState>
Chrome 116 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
setDetectionInterval()
chrome.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
chrome.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.