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