idle.queryState()

Gibt "locked" zurück, wenn das System gesperrt ist, "idle", wenn der Benutzer für eine bestimmte Anzahl von Sekunden keine Eingaben gemacht hat, oder "active" andernfalls.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let querying = browser.idle.queryState(
  detectionIntervalInSeconds // integer
)

Parameter

detectionIntervalInSeconds

integer. Das System wird als untätig betrachtet, wenn detectionIntervalInSeconds Sekunden vergangen sind, seit die letzte Benutzereingabe erkannt wurde.

Rückgabewert

Ein Promise, das mit einem idle.IdleState-String erfüllt wird, der den aktuellen Zustand angibt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

In diesem einfachen Snippet rufen wir queryState() auf und prüfen dann, ob der zurückgegebene newState idle oder active ist, und protokollieren eine entsprechende Nachricht. Da wir einen detectionIntervalInSeconds von 15 angegeben haben, wird ein idle-Zustand nur gemeldet, wenn es mindestens 15 Sekunden lang keine Benutzeraktivität gab.

js
function onGot(newState) {
  if (newState === "idle") {
    console.log("Please come back — we miss you!");
  } else if (newState === "active") {
    console.log("Glad to still have you with us!");
  }
}

let querying = browser.idle.queryState(15);
querying.then(onGot);

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