chrome.idle

Beschreibung

Verwenden Sie die chrome.idle API, um zu erkennen, wenn sich der Inaktivitätsstatus der Maschine ändert.

Berechtigungen

idle

Du musst die Berechtigung "idle" im Manifest deiner Erweiterung deklarieren, um die inaktive API verwenden zu können. Beispiel:

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

Typen

IdleState

Chrome (ab Version 44)

Enum

"aktiv"

„idle“

"locked"

Methoden

getAutoLockDelay()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 73 und höher Nur ChromeOS
chrome.idle.getAutoLockDelay(
  callback?: function,
)

Ruft die Zeit in Sekunden ab, die benötigt wird, bis der Bildschirm bei Inaktivität automatisch gesperrt wird. Gibt die Dauer von null zurück, wenn der Bildschirm nie automatisch gesperrt wird. Wird derzeit nur unter ChromeOS unterstützt.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (delay: number) => void

    • delay

      Zahl

      Zeit in Sekunden, bis der Bildschirm bei Inaktivität automatisch gesperrt wird. Dieser Wert ist null, wenn der Bildschirm nie automatisch gesperrt wird.

Gibt Folgendes zurück:

  • Promise&lt;number&gt;

    Chrome 116 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

queryState()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
)

Gibt „locked“ zurück wenn das System gesperrt ist: „inaktiv“ Der Nutzer hat für eine bestimmte Anzahl von Sekunden keine Eingabe oder „aktiv“. sonst.

Parameter

  • detectionIntervalInSeconds

    Zahl

    Das System gilt als inaktiv, wenn „ DetectionIntervalInSeconds Sekunden“ seit der letzten Nutzereingabe verstrichen ist.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (newState: IdleState) => void

Gibt Folgendes zurück:

  • Promise&lt;IdleState&gt;

    Chrome 116 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

Legt das Intervall in Sekunden fest, mit dem ermittelt wird, wann das System für onStateChanged-Ereignisse inaktiv ist. Das Standardintervall beträgt 60 Sekunden.

Parameter

  • intervalInSeconds

    Zahl

    Grenzwert in Sekunden, mit dem bestimmt wird, wann das System inaktiv ist.

Ereignisse

onStateChanged

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

Wird ausgelöst, wenn das System in den Status „Aktiv“, „Inaktiv“ oder „Gesperrt“ wechselt. Das Ereignis wird mit „Gesperrt“ ausgelöst. „Inaktiv“, wenn das Display gesperrt oder der Bildschirmschoner aktiviert wird Das System ist entsperrt und der Nutzer hat für eine bestimmte Anzahl von Sekunden keine Eingabe generiert. Der Nutzer generiert Eingaben auf einem inaktiven System.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (newState: IdleState) => void