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