idle.onStateChanged

当系统变为活动、空闲或锁定状态时触发。事件监听器会接收到一个具有以下三种值之一的字符串。

  • "locked":屏幕被锁定或屏幕保护程序激活。
  • "idle":系统未锁定,并且用户在指定的秒数内未进行任何输入。此秒数默认为 60,但可以使用 idle.setDetectionInterval() 进行设置。
  • "active":当用户在空闲的系统上进行输入时。

语法

js
browser.idle.onStateChanged.addListener(listener)
browser.idle.onStateChanged.removeListener(listener)
browser.idle.onStateChanged.hasListener(listener)

事件有三个函数

addListener(listener)

向此事件添加监听器。

removeListener(listener)

停止监听此事件。listener 参数是要移除的监听器。

hasListener(listener)

检查 listener 是否已为此事件注册。如果正在监听,则返回 true,否则返回 false

addListener 语法

参数

监听器

当此事件发生时调用的函数。该函数将传递此参数

newState

idle.IdleState。新的空闲状态。

示例

js
function newState(state) {
  console.log(`New state: ${state}`);
}

browser.idle.onStateChanged.addListener(newState);

浏览器兼容性

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