webNavigation.onTabReplaced

当标签页的内容被另一个(通常是之前预渲染的)标签页替换时触发此事件。

语法

js
browser.webNavigation.onTabReplaced.addListener(
  listener,                   // 函数
  filter                      // 可选对象
);
browser.webNavigation.onTabReplaced.removeListener(listener)
browser.webNavigation.onTabReplaced.hasListener(listener)

事件包含三个函数:

addListener(listener)

为此事件添加监听器。

removeListener(listener)

停止监听此事件。listener 参数是要移除的监听器。

hasListener(listener)

检查是否已为此事件注册了 listener。如果正在监听,则返回 true,否则返回 false

addListener 语法

参数

listener

事件触发时调用的函数。该函数接收以下参数:

details

object。有关导航事件的详细信息。参见 details 部分以了解更多信息。

附加对象

details

replacedTabId

integer。被替换的标签页的 ID。

tabId

integer。替换旧标签页的新标签页的 ID。

timeStamp

number。替换发生的时间,以自纪元以来的毫秒数表示。

浏览器兼容性

示例

js
function logOnTabReplaced(details) {
  console.log(`onTabReplaced ${details}`);
}

browser.webNavigation.onTabReplaced.addListener(logOnTabReplaced);

备注: 此 API 基于 Chromium 的 chrome.webNavigation API。该文档衍生自 Chromium 代码中的 web_navigation.json