browser.idle

Beschrijving

Gebruik de chrome.idle API om te detecteren wanneer de inactieve status van de machine verandert.

Rechten

idle

Je moet het recht "idle" definiëren in het manifest van je extensie om de Idle API te gebruiken. Voorbeeld:

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

Typen

IdleState

Chrome 44+ browser.* sinds Chrome 148

Enum

active

"idle"

"locked"

Methoden

getAutoLockDelay()

Chrome 73 en hoger browser.* sinds Chrome 148 Alleen ChromeOS
browser.idle.getAutoLockDelay(): 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.

Retourzendingen

  • Promise<number>

    Chrome 116+ browser.* sinds Chrome 148

queryState()

browser.idle.queryState(
  detectionIntervalInSeconds: number,
)
: 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.

Retourzendingen

  • Promise<IdleState>

    Chrome 116+ browser.* sinds Chrome 148

setDetectionInterval()

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit:

    (newState: IdleState) => void