tabs.onReplaced

当一个标签页由于预渲染或立即被另一个标签页替换时触发。

除了 Chrome 浏览器之外的浏览器可能不支持这个事件。

语法

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 语法

参数

listener

此事件发生时调用的函数。该函数接收以下参数：

addedTabId: integer。替换标签页的 ID。
removedTabId: integer。被替换标签页的 ID。

示例

监听替换事件，并记录相关信息：

function handleReplaced(addedTabId, removedTabId) {
  console.log(`新标签页：${addedTabId}`);
  console.log(`旧标签页：${removedTabId}`);
}

browser.tabs.onReplaced.addListener(handleReplaced);

浏览器兼容性

BCD tables only load in the browser

备注：该 API 基于 Chromium 的 chrome.tabs API。此文档来自 Chromium 代码中的 tabs.json。