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 语法
参数
附加对象
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
。