chroom.inactief

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

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

Toestemmingen

idle

Manifest

Om de Idle API te kunnen gebruiken, moet u de "idle"-toestemming in het manifest van uw extensie declareren. Bijvoorbeeld:

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

Soorten

IdleState

Chrome 44+

Enum

"actief"

"inactief"

"vergrendeld"

Methoden

getAutoLockDelay()

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

Geeft de tijd in seconden weer die verstrijkt voordat het scherm automatisch wordt vergrendeld in de inactieve stand. Geeft nul seconden terug als het scherm nooit automatisch wordt vergrendeld. Momenteel alleen ondersteund op Chrome OS.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (delay: number) => void

    • vertraging

      nummer

      De tijd, in seconden, totdat het scherm automatisch wordt vergrendeld wanneer het niet in gebruik is. Deze waarde is nul als het scherm nooit automatisch wordt vergrendeld.

Retourneert

  • Belofte<nummer>

    Chrome 116+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

queryState()

Belofte
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

Geeft "locked" terug als het systeem vergrendeld is, "idle" als de gebruiker gedurende een bepaald aantal seconden geen invoer heeft gegeven, of "active" in alle andere gevallen.

Parameters

  • detectie-interval in seconden

    nummer

    Het systeem wordt als inactief beschouwd als er detectionIntervalInSeconds seconden zijn verstreken sinds de laatste gebruikersinvoer is gedetecteerd.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (newState: IdleState) => void

Retourneert

  • Promise< IdleState >

    Chrome 116+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

Hiermee wordt het interval in seconden ingesteld dat wordt gebruikt om te bepalen wanneer het systeem zich in een inactieve toestand bevindt voor onStateChanged-gebeurtenissen. Het standaardinterval is 60 seconden.

Parameters

  • intervalInSeconden

    nummer

    Drempelwaarde, in seconden, die wordt gebruikt om te bepalen wanneer het systeem in een inactieve toestand verkeert.

Evenementen

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

Deze gebeurtenis wordt geactiveerd wanneer het systeem overgaat naar een actieve, inactieve of vergrendelde status. De gebeurtenis wordt geactiveerd met "locked" als het scherm vergrendeld is of de schermbeveiliging is geactiveerd, met "idle" als het systeem ontgrendeld is en de gebruiker gedurende een bepaald aantal seconden geen invoer heeft gegeven, en met "active" wanneer de gebruiker invoer geeft op een inactief systeem.

Parameters