idle.queryState()
如果系统已锁定,则返回 "locked"
;如果用户在指定秒数内没有生成任何输入,则返回 "idle"
;否则返回 "active"
。
这是一个异步函数,它返回一个 Promise
。
语法
js
let querying = browser.idle.queryState(
detectionIntervalInSeconds // integer
)
参数
detectionIntervalInSeconds
-
integer
。如果自检测到最后一次用户输入以来已过去detectionIntervalInSeconds
秒,则系统将被视为处于空闲状态。
返回值
一个 Promise
,它将使用一个 idle.IdleState
字符串来完成,指示当前状态。
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
示例
在这个简单的代码片段中,我们调用 queryState()
,然后检查返回的 newState
是否为 idle
或 active
,并根据情况记录一条消息。因为我们指定了 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
。