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 语法

参数

listener

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

newState

idle.IdleState。新的空闲状态。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

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

browser.idle.onStateChanged.addListener(newState);

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