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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
queryState
locked

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

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.