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