chrome.idle

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

Chrome 44 e versioni successive

Enum

Metodi

getAutoLockDelay()

Promise Chrome 73 e versioni successive Solo ChromeOS 
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 successive

    Le 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()

Promessa 
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

Ritorni

  • Promise<IdleState>

    Chrome 116 e versioni successive

    Le 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.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (newState: IdleState)=>void