refresh date: 2026-09-25 robots: noindex
Beschrijving
Gebruik de chrome.idle API om te detecteren wanneer de inactieve status van de machine verandert.
Rechten
idleManifest
Je moet het recht 'idle' definiëren in het manifest van je extensie om de API voor inactiviteit te gebruiken. Voorbeeld:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
Typen
IdleState
Enum
active
"idle"
"locked"
Methoden
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
): Promise<number>
Haalt de tijd op (in seconden) die het duurt voordat het scherm automatisch wordt vergrendeld als het inactief is. Retourneert een duur van 0 als het scherm nooit automatisch wordt vergrendeld. Wordt op dit moment alleen ondersteund in ChromeOS.
Parameters
-
callback
functie optioneel
De parameter
callbackziet er zo uit:(delay: number) => void
-
vertraging
getal
De tijd in seconden voordat het scherm automatisch wordt vergrendeld als het inactief is. Dit is 0 als het scherm nooit automatisch wordt vergrendeld.
-
Retourzendingen
-
Promise<number>
Chrome 116 of hogerPromises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
): Promise<IdleState>
Retourneert 'locked' als het systeem is vergrendeld, 'idle' als de gebruiker gedurende een bepaald aantal seconden geen invoer heeft gegenereerd of anders 'active'.
Parameters
-
detectionIntervalInSeconds
getal
Het systeem wordt als inactief beschouwd als er detectionIntervalInSeconds seconden zijn verstreken sinds de laatste gebruikersinvoer is waargenomen.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:(newState: IdleState) => void
-
newState
-
Retourzendingen
-
Promise<IdleState>
Chrome 116 of hogerPromises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
): void
Stelt het interval in seconden in dat wordt gebruikt om te bepalen wanneer het systeem in een inactieve status is voor onStateChanged-gebeurtenissen. Het standaardinterval is 60 seconden.
Parameters
-
intervalInSeconds
getal
Drempelwaarde, in seconden, die wordt gebruikt om te bepalen wanneer het systeem inactief is.
Evenementen
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
Wordt geactiveerd als het systeem overschakelt naar een actieve, inactieve of vergrendelde status. De gebeurtenis wordt geactiveerd met 'locked' als het scherm is vergrendeld of de screensaver wordt geactiveerd, 'idle' als het systeem is ontgrendeld en de gebruiker gedurende een bepaald aantal seconden geen invoer heeft gegenereerd, en 'active' als de gebruiker invoer genereert op een inactief systeem.