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