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