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 语法
参数
监听器
-
当此事件发生时调用的函数。该函数将传递此参数
activeInfo
-
对象
。已激活的标签页的 ID 及其窗口的 ID。有关更多详细信息,请参见 activeInfo 部分。
其他对象
activeInfo
previousTabId
-
整数
。先前激活的标签页的 ID(如果该标签页仍处于打开状态)。 tabId
-
整数
。已成为活动标签页的 ID。 windowId
-
整数
。标签页窗口的 ID。
示例
侦听并记录标签页激活事件
js
function handleActivated(activeInfo) {
console.log(`Tab ${activeInfo.tabId} was activated`);
}
browser.tabs.onActivated.addListener(handleActivated);
扩展示例
浏览器兼容性
BCD 表格仅在启用了
注意:此 API 基于 Chromium 的 chrome.tabs
API。本文件来自 Chromium 代码中的 tabs.json
。