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