windows.onFocusChanged

噹噹前獲得焦點的視窗發生變化時觸發。如果所有瀏覽器視窗都已失去焦點,則值為 windows.WINDOW_ID_NONE

注意: 在 Windows 和某些 Linux 視窗管理器中,在從一個瀏覽器視窗切換到另一個瀏覽器視窗之前,WINDOW_ID_NONE 始終會被髮送。

語法

js
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 語法

引數

監聽器

當此事件發生時呼叫的函式。該函式將傳遞此引數

windowId

integer。新獲得焦點的視窗的 ID。

示例

記錄焦點變化

js
browser.windows.onFocusChanged.addListener((windowId) => {
  console.log(`Newly focused window: ${windowId}`);
});

擴充套件程式示例

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.windows API。本文件源自 Chromium 程式碼中的 windows.json