选项卡.onHighlighted

当窗口中突出显示的选项卡集发生变化时触发。

请注意，在 63 版之前，Firefox 没有突出显示多个选项卡的概念，因此此事件只是 tabs.onActivated 的别名。

语法

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 语法

参数

listener

当此事件发生时调用的函数。该函数传递此参数

highlightInfo: 对象。突出显示的选项卡的 ID 和其窗口的 ID。有关更多详细信息，请参阅 highlightInfo 部分。

其他对象

highlightInfo

windowId: 整数。选项卡发生更改的窗口的 ID。
tabIds: 整数 的 数组。窗口中突出显示的选项卡的 ID。

示例

侦听突出显示事件，并记录突出显示的选项卡的 ID

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

browser.tabs.onHighlighted.addListener(handleHighlighted);

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

注意：此 API 基于 Chromium 的 chrome.tabs API。此文档源自 Chromium 代码中的 tabs.json。