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
。