idle.queryState()

如果系统已锁定,则返回 "locked";如果用户在指定秒数内没有生成任何输入,则返回 "idle";否则返回 "active"

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

语法

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

参数

detectionIntervalInSeconds

integer。如果自检测到最后一次用户输入以来已过去 detectionIntervalInSeconds 秒,则系统将被视为处于空闲状态。

返回值

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

在这个简单的代码片段中,我们调用 queryState(),然后检查返回的 newState 是否为 idleactive,并根据情况记录一条消息。因为我们指定了 detectionIntervalInSeconds 为 15,所以只有在至少 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