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

object。被激活的标签页的 ID 及其所属窗口的 ID。有关更多详情,请参阅 activeInfo 部分。

额外对象

activeInfo

previousTabId

integer。前一个激活的标签页的 ID,前提是该标签页仍然打开。

tabId

integer。已激活的标签页的 ID。

windowId

integer。标签页所属窗口的 ID。

示例

监听并记录标签页激活事件

js
function handleActivated(activeInfo) {
  console.log(`Tab ${activeInfo.tabId} was activated`);
}

browser.tabs.onActivated.addListener(handleActivated);

扩展程序示例

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.tabs API。本文档源自 Chromium 代码中的 tabs.json