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