history.onVisited
每次用户访问页面时触发。一个 history.HistoryItem
对象将传递给监听器。此事件在页面加载之前触发。
语法
js
browser.history.onVisited.addListener(listener)
browser.history.onVisited.removeListener(listener)
browser.history.onVisited.hasListener(listener)
事件有三个函数
addListener(listener)
-
将监听器添加到此事件。
removeListener(listener)
-
停止监听此事件。
listener
参数是要删除的监听器。 hasListener(listener)
-
检查
listener
是否为此事件注册。如果正在监听,则返回true
,否则返回false
。
addListener 语法
参数
listener
-
当此事件发生时调用的函数。该函数将传递此参数
result
-
history.HistoryItem
。表示浏览器历史记录中项目的对象。在此事件发送时,浏览器尚不知道页面的标题。如果浏览器之前访问过此页面并记住其旧标题,则
HistoryItem.title
对象将包含页面的旧标题。如果浏览器没有页面旧标题的记录,则HistoryItem.title
将为空。要获取页面标题,一旦它们被识别,请监听history.onTitleChanged
。
浏览器兼容性
BCD 表格仅在浏览器中加载
示例
监听访问,并记录 URL 和访问时间。
js
function onVisited(historyItem) {
console.log(historyItem.url);
console.log(new Date(historyItem.lastVisitTime));
}
browser.history.onVisited.addListener(onVisited);
注意:此 API 基于 Chromium 的 chrome.history
API。本文档源自 Chromium 代码中的 history.json
。