history

使用 history API 與瀏覽器歷史記錄進行互動。

如果您正在查詢關於瀏覽器會話歷史記錄的資訊,請參閱 History 介面

注意: 下載被視為 HistoryItem 物件。因此,諸如 history.onVisited 等事件會為下載觸發。

瀏覽器歷史記錄是使用者訪問過的頁面的按時間順序排列的記錄。history API 使您能夠

但是,使用者可能多次訪問過同一頁面,因此該 API 還包含了“訪問”的概念。所以您也可以使用此 API 來

要使用此 API,擴充套件必須在其 manifest.json 檔案中請求 "history" 許可權

型別

history.TransitionType

描述了瀏覽器如何導航到某個特定頁面。

history.HistoryItem

提供有關瀏覽器歷史記錄中某個特定頁面的資訊。

history.VisitItem

描述對某個頁面的單次訪問。

函式

history.search()

在瀏覽器歷史記錄中搜索與給定條件匹配的 history.HistoryItem 物件。

history.getVisits()

檢索關於給定頁面訪問的資訊。

history.addUrl()

將對給定頁面的訪問記錄新增到瀏覽器歷史記錄中。

history.deleteUrl()

從瀏覽器歷史記錄中刪除對給定 URL 的所有訪問。

history.deleteRange()

刪除使用者在給定時間範圍內訪問過的所有頁面的訪問記錄。

history.deleteAll()

從瀏覽器歷史記錄中刪除所有訪問記錄。

事件

history.onTitleChanged

當用戶訪問的頁面的標題被記錄時觸發。

history.onVisited

每次使用者訪問頁面時觸發,提供該頁面的 history.HistoryItem 資料。

history.onVisitRemoved

當 URL 被完全從瀏覽器歷史記錄中刪除時觸發。

擴充套件程式示例

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.history API。本文件源自 Chromium 程式碼中的 history.json