history.getVisits()

检索给定 URL 的所有访问记录信息。

这是一个异步函数,返回一个 Promise

语法

js
let getting = browser.history.getVisits(
  details                // object
)

参数

details

具有以下属性的对象:

url

string。要检索访问记录信息的 URL。

返回值

一个 Promise 将会解析为一个 history.VisitItem 对象数组,每个对象代表对给定 URL 的一次访问。访问记录按时间倒序排列。

示例

列出最近访问页面的所有访问记录

js
function gotVisits(visits) {
  console.log(`Visit count: ${visits.length}`);
  for (const visit of visits) {
    console.log(visit.visitTime);
  }
}

function listVisits(historyItems) {
  if (historyItems.length) {
    console.log(`URL ${historyItems[0].url}`);
    const gettingVisits = browser.history.getVisits({
      url: historyItems[0].url,
    });
    gettingVisits.then(gotVisits);
  }
}

let searching = browser.history.search({
  text: "",
  startTime: 0,
  maxResults: 1,
});

searching.then(listVisits);

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.history API。本文档源自 Chromium 代码中的 history.json