idle.queryState()

Renvoie "locked" si le système est vérouillé, "inactif" si l'utilisation n'a généré aucune entrée pendant un nombre de secondes spécifié, ou "actif" dans le cas contraire.

Il s'agit d'une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
var querying = browser.idle.queryState(
  detectionIntervalInSeconds, // integer
);

Paramètres

detectionIntervalInSeconds

integer. Le système est considéré inactif si detectionIntervalInSeconds secondes s'est écoulé depuis la dernière entrée utilisateur détectée.

Valeur renvoyée

Une Promise qui sera remplie avec une chaîne idle.IdleState, indiquant l'état actuel.

Compatibilité des navigateurs

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.

Exemples

Dans cet extrait simple, nous appelons queryState() et vérifions si le newState est inactif ou active, en enregistrant un message selon le cas. Comme nous avons spécifié une valeur de detectionIntervalInSeconds de 15, un état inactif ne sera signalé que s'il n'y a pas eu d'activité de l'utilisateur depuis au moins 15 secondes

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!");
  }
}

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

Note :

Cette API est basée sur l'API Chromium chrome.idle. Cette documentation est dérivée de idle.json dans le code Chromium.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.