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 语法
参数
listener
-
此事件发生时调用的函数。该函数接收以下参数:
highlightInfo
-
object
。被高亮标签页的 ID 及其窗口的 ID。详见 highlightInfo 部分。
附加对象
highlightInfo
示例
监听高亮事件,并记录被高亮标签页的 ID:
js
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
。