tabs.onAttached

当标签页附加到窗口时触发,例如因为它在窗口之间移动。

语法

js
browser.tabs.onAttached.addListener(listener)
browser.tabs.onAttached.removeListener(listener)
browser.tabs.onAttached.hasListener(listener)

事件有三个函数

addListener(listener)

向此事件添加监听器。

removeListener(listener)

停止监听此事件。listener 参数是要移除的监听器。

hasListener(listener)

检查 listener 是否已为此事件注册。如果正在监听,则返回 true,否则返回 false

addListener 语法

参数

监听器

此事件发生时调用的函数。该函数会传递以下参数:

tabId

integer。已附加到新窗口的标签页的 ID。

attachInfo

object。新窗口的 ID,以及其中标签页的索引。有关更多详细信息,请参阅 attachInfo 部分。

额外对象

attachInfo

newWindowId

integer。新窗口的 ID。

newPosition

integer。标签页在新窗口中的索引位置。

示例

监听附加事件,并记录信息

js
function handleAttached(tabId, attachInfo) {
  console.log(`Tab: ${tabId} attached`);
  console.log(`New window: ${attachInfo.newWindowId}`);
  console.log(`New index: ${attachInfo.newPosition}`);
}

browser.tabs.onAttached.addListener(handleAttached);

浏览器兼容性

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