tabs.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: object。被高亮标签页的 ID 及其窗口的 ID。详见 highlightInfo 部分。

附加对象

highlightInfo

windowId: integer。发生标签页更改的窗口的 ID。
tabIds: integer 数组。窗口中被高亮的标签页的 ID。

示例

监听高亮事件，并记录被高亮标签页的 ID：

function handleHighlighted(highlightInfo) {
  console.log(`高亮标签页：${highlightInfo.tabIds}`);
}

browser.tabs.onHighlighted.addListener(handleHighlighted);

浏览器兼容性

BCD tables only load in the browser

备注： 该 API 基于 Chromium 的 chrome.tabs API。此文档来自 Chromium 代码中的 tabs.json。