tabs.onReplaced

當由於預渲染或即時載入導致一個標籤頁被另一個標籤頁替換時觸發。

此事件可能不適用於 Chrome 以外的瀏覽器,或者在 Chrome 以外的瀏覽器中不受支援。

語法

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

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

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

hasListener(listener)

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

addListener 語法

引數

監聽器

此事件發生時呼叫的函式。該函式會傳遞以下引數:

addedTabId

integer。替換標籤頁的 ID。

removedTabId

integer。被替換的標籤頁的 ID。

示例

監聽替換事件,並記錄相關資訊

js
function handleReplaced(addedTabId, removedTabId) {
  console.log(`New tab: ${addedTabId}`);
  console.log(`Old tab: ${removedTabId}`);
}

browser.tabs.onReplaced.addListener(handleReplaced);

瀏覽器相容性

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