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。