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