history.getVisits()

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

这是一个异步函数，它返回一个 Promise。

语法

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

参数

details

具有以下属性的对象

url

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

返回值

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

浏览器兼容性

BCD 表仅在浏览器中加载

示例

列出对最近访问的页面所有访问

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。