tabs.onDetached

当选项卡从窗口分离时触发,例如,因为它正在窗口之间移动。

语法

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

事件有三个函数

addListener(listener)

为该事件添加侦听器。

removeListener(listener)

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

hasListener(listener)

检查是否为该事件注册了 listener。如果正在侦听,则返回 true,否则返回 false

addListener 语法

参数

listener

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

tabId

整数。已分离选项卡的 ID。

detachInfo

对象。先前窗口的 ID,以及该选项卡在其中的索引。有关更多详细信息,请参阅 detachInfo 部分。

其他对象

detachInfo

oldWindowId

整数。先前窗口的 ID。

oldPosition

整数。选项卡在先前窗口中的索引位置。

示例

侦听分离事件并记录信息

js
function handleDetached(tabId, detachInfo) {
  console.log(`Tab: ${tabId} moved`);
  console.log(`Old window: ${detachInfo.oldWindowId}`);
  console.log(`Old index: ${detachInfo.oldPosition}`);
}

browser.tabs.onDetached.addListener(handleDetached);

浏览器兼容性

BCD 表仅在浏览器中加载

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