tabs.onActivated

當一個視窗中的活動標籤頁發生變化時觸發。請注意,在觸發此事件時,標籤頁的 URL 可能尚未設定,但您可以監聽 tabs.onUpdated 事件,以便在 URL 設定時收到通知。

語法

js
browser.tabs.onActivated.addListener(listener)
browser.tabs.onActivated.removeListener(listener)
browser.tabs.onActivated.hasListener(listener)

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查 listener 是否已為此事件註冊。如果正在監聽,則返回 true,否則返回 false

addListener 語法

引數

監聽器

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

activeInfo

object。被啟用的標籤頁的 ID 及其所屬視窗的 ID。有關更多詳情,請參閱 activeInfo 部分。

額外物件

activeInfo

previousTabId

integer。前一個啟用的標籤頁的 ID,前提是該標籤頁仍然開啟。

tabId

integer。已啟用的標籤頁的 ID。

windowId

integer。標籤頁所屬視窗的 ID。

示例

監聽並記錄標籤頁啟用事件

js
function handleActivated(activeInfo) {
  console.log(`Tab ${activeInfo.tabId} was activated`);
}

browser.tabs.onActivated.addListener(handleActivated);

擴充套件程式示例

瀏覽器相容性

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