idle.queryState()

如果系统处于锁定状态,则返回 "locked";如果用户在指定秒数内未产生任何输入,则返回 "idle";否则返回 "active"

这是一个异步函数,返回一个 Promise

语法

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

参数

detectionIntervalInSeconds

integer。如果在检测到最后一次用户输入后经过了 detectionIntervalInSeconds 秒,则认为系统处于空闲状态。

返回值

一个 Promise,它将以一个 idle.IdleState 字符串完成,该字符串指示当前状态。

示例

在此简单代码片段中,我们调用 queryState(),然后检查返回的 newState 是否为 idleactive,并据此记录一条消息。因为我们指定了 15 秒的 detectionIntervalInSeconds,所以只有在至少 15 秒内没有任何用户活动的情况下,才会报告 idle 状态。

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);

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.idle API。此文档源自 Chromium 代码中的 idle.json