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

参数

监听器

当此事件发生时调用的函数。该函数将传递此参数

result

history.HistoryItem。一个代表浏览器历史记录中项目的对象。

发送此事件时,浏览器尚不知道页面的标题。如果浏览器之前访问过此页面并且记住了其旧标题,则 HistoryItem.title 对象将包含该页面的旧标题。如果浏览器没有记录页面的旧标题,则 HistoryItem.title 将为空。要尽快获取页面标题,请监听 history.onTitleChanged

示例

监听访问,并记录 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