chrome.idle

Descrizione

Utilizza l'API chrome.idle per rilevare quando cambia lo stato di inattività della macchina.

Autorizzazioni

idle

Manifest

Per utilizzare l'API idle, devi dichiarare l'autorizzazione "idle" nel manifest dell'estensione. Ad esempio:

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

Tipi

IdleState

Chrome 44+

Enum

"active"

"idle"

"locked"

Metodi

getAutoLockDelay()

Promise Chrome 73+ Solo ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

Restituisce il tempo, in secondi, che trascorre prima che lo schermo si blocchi automaticamente in stato di inattività. Restituisce una durata pari a zero se lo schermo non viene mai bloccato automaticamente. Al momento 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 si blocchi automaticamente in stato di inattività. Questo valore è zero se lo schermo non si blocca mai automaticamente.

Resi

  • Promise<number>

    Chrome 116+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

queryState()

Promessa 
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 specificato di secondi 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 facoltativa

    Il parametro callback ha il seguente aspetto: 

    (newState: IdleState) => void

Resi

  • Promise<IdleState>

    Chrome 116+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, 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 è 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 viene attivato con "locked" se lo schermo è bloccato o se viene attivato il salvaschermo, "idle" se il sistema è sbloccato e l'utente non ha generato alcun input per un numero specificato di secondi e "active" quando l'utente genera input su un sistema inattivo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (newState: IdleState) => void