idle.onStateChanged

Wird ausgelöst, wenn das System in einen aktiven, inaktiven oder gesperrten Zustand wechselt. Der Ereignis-Listener erhält einen String, der einen von drei Werten hat:

  • "locked", wenn der Bildschirm gesperrt ist oder der Bildschirmschoner aktiviert wird
  • "idle", wenn das System entsperrt ist und der Benutzer für eine angegebene Anzahl von Sekunden keine Eingabe getätigt hat. Diese Zahl ist standardmäßig auf 60 eingestellt, kann aber mit idle.setDetectionInterval() festgelegt werden.
  • "active", wenn der Benutzer auf einem inaktiven System eine Eingabe erzeugt.

Syntax

js
browser.idle.onStateChanged.addListener(listener)
browser.idle.onStateChanged.removeListener(listener)
browser.idle.onStateChanged.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Hört auf, diesem Ereignis zuzuhören. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es zuhört, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird dieses Argument übergeben:

newState

idle.IdleState. Der neue inaktive Zustand.

Browser-Kompatibilität

Beispiele

js
function newState(state) {
  console.log(`New state: ${state}`);
}

browser.idle.onStateChanged.addListener(newState);

Hinweis: Diese API basiert auf Chromiums chrome.idle API. Diese Dokumentation basiert auf idle.json im Chromium-Code.