tabs.onHighlighted

當視窗中選中的標籤頁集合發生變化時觸發。

請注意,在 63 版本之前,Firefox 沒有多選標籤頁的概念,因此該事件只是 tabs.onActivated 的別名。

語法

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

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

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

hasListener(listener)

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

addListener 語法

引數

監聽器

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

highlightInfo

object。被選中標籤頁的 ID,以及其所在視窗的 ID。更多資訊請參見 highlightInfo 部分。

額外物件

highlightInfo

windowId

integer。發生標籤頁變化的視窗 ID。

tabIds

array of integer。視窗中被選中標籤頁的 ID 列表。

示例

監聽選中事件,並記錄被選中標籤頁的 ID。

js
function handleHighlighted(highlightInfo) {
  console.log(`Highlighted tabs: ${highlightInfo.tabIds}`);
}

browser.tabs.onHighlighted.addListener(handleHighlighted);

瀏覽器相容性

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