windows.onFocusChanged

We'd love to hear more about your role and the company you work for

Please help us by answering a few questions.

在当前聚焦的窗口发生变化时触发。如果所有浏览器窗口都失去焦点，则会是 windows.WINDOW_ID_NONE。

备注： 在 Windows 和部分 Linux 窗口管理器中，将始终在从一个浏览器窗口切换到另一个浏览器窗口之前立即发送 WINDOW_ID_NONE。

语法

browser.windows.onFocusChanged.addListener(listener)
browser.windows.onFocusChanged.removeListener(listener)
browser.windows.onFocusChanged.hasListener(listener)

事件有三个函数：

addListener(listener): 为此事件添加监听器。
removeListener(listener): 停止监听此事件。listener 参数是要移除的监听器。
hasListener(listener): 检查是否已为此事件注册了 listener。如果正在监听，则返回 true，否则返回 false。

addListener 语法

参数

listener

事件触发时调用的函数。该函数接收以下参数：

windowId: integer。新聚焦的窗口 ID。

浏览器兼容性

示例

记录焦点的变化：

browser.windows.onFocusChanged.addListener((windowId) => {
  console.log(`新聚焦的窗口：${windowId}`);
});

示例扩展

bookmark-it

备注： 此 API 基于 Chromium 的 chrome.windows API。该文档衍生自 Chromium 代码中的 windows.json。