history
使用 history
API 与浏览器历史记录进行交互。
备注:下载也被当做一个 HistoryItem
对象。因此,history.onVisited
等事件也会被下载所触发。
浏览器历史记录是对用户所访问的页面按时间顺序进行的记录和保存。history API 可以帮你实现以下功能:
然而,用户可能多次访问单个页面,因此 API 中有访问集合“visits”的概念。所以,该 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 被彻底从浏览器历史记录中移除时触发。
浏览器兼容性
BCD tables only load in the browser
示例扩展
备注:该 API 基于 Chromium 的 chrome.history
API。该文档由 Chromium 代码中的 history.json
衍生而来。