tabs.onActivated
当窗口中的活动标签页更改时触发。请注意,此事件触发时,标签页的 URL 可能尚未设置,但你可以监听 tabs.onUpdated
事件,以便在设置 URL 时收到通知。
语法
js
browser.tabs.onActivated.addListener(listener)
browser.tabs.onActivated.removeListener(listener)
browser.tabs.onActivated.hasListener(listener)
事件具有三个函数:
addListener(listener)
-
向此事件添加一个监听器。
removeListener(listener)
-
停止监听此事件。
listener
参数是要移除的监听器。 hasListener(listener)
-
检查
listener
是否已注册此事件。如果正在监听,则返回true
,否则返回false
。
addListener 语法
参数
listener
-
此事件发生时调用的函数。该函数接收以下参数:
activeInfo
-
object
。被激活的标签页的 ID 及其窗口的 ID。详见 activeInfo 部分。
附加对象
activeInfo
previousTabId
-
integer
。上一个被激活的标签页的 ID(如果该标签页仍然打开)。 tabId
-
integer
。已被激活的标签页的 ID。 windowId
-
integer
。标签页所属窗口的 ID。
示例
监听并记录标签页激活事件:
js
function handleActivated(activeInfo) {
console.log(`标签页 ${activeInfo.tabId} 已激活`);
}
browser.tabs.onActivated.addListener(handleActivated);
示例扩展
浏览器兼容性
BCD tables only load in the browser
备注:
该 API 基于 Chromium 的 chrome.tabs
API。此文档来自 Chromium 代码中的 tabs.json
。