history
使用history
API 与浏览器历史记录交互。
如果您正在寻找有关浏览器会话历史记录的信息,请参阅History 接口。
注意:下载被视为HistoryItem
对象。因此,诸如history.onVisited
之类的事件会为下载触发。
浏览器历史记录是用户访问过的页面的时间顺序记录。history API 使您能够
但是,用户可能多次访问过单个页面,因此 API 还具有“访问”的概念。因此,您还可以使用此 API 来
要使用此 API,扩展程序必须在其权限中请求“history”manifest.json
文件。
类型
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 表格仅在启用 JavaScript 的浏览器中加载。
示例扩展
注意:此 API 基于 Chromium 的chrome.history
API。本文档源自 Chromium 代码中的history.json
。