tabs.onCreated

標籤被建立時觸發。

請注意,在該事件觸發時,標籤的 URL 可能尚未設定為最終值。特別是,Firefox 會先開啟一個 URL 為“about:blank”的新標籤頁,然後再載入實際的新頁面。你可以監聽 tabs.onUpdated 事件,以便在 URL 設定時收到通知。

語法

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

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查 listener 是否已為此事件註冊。如果正在監聽,則返回 true,否則返回 false

addListener 語法

引數

監聽器

當此事件發生時呼叫的函式。該函式將傳遞此引數

tab

tabs.Tab。已建立標籤的詳細資訊。

示例

記錄新建立標籤的 ID

js
function handleCreated(tab) {
  console.log(tab.id);
}

browser.tabs.onCreated.addListener(handleCreated);

擴充套件程式示例

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.tabs API。本文件內容源自 Chromium 程式碼中的 tabs.json