browsingData

使扩展程序能够清除用户在浏览时累积的数据。

browsingData API 中,浏览数据被划分为几种类型:

  • 浏览器缓存
  • cookies
  • downloads
  • history
  • 本地存储
  • 插件数据
  • 保存的表单数据
  • 保存的密码

您可以使用 browsingData.remove() 函数来删除这些类型的任意组合。还有专门的函数用于删除每种特定类型的数据,例如 removePasswords()removeHistory() 等等。

所有 browsingData.remove[X]() 函数都接受一个 browsingData.RemovalOptions 对象,您可以使用它来进一步控制数据删除的两个方面:

  • 要删除数据的追溯时间范围
  • 是仅从普通网页删除数据,还是也从托管的 Web 应用和附加组件中删除数据。请注意,此选项在 Firefox 中尚未支持。

最后,此 API 提供了一个 browsingData.settings() 函数,它会为您提供浏览器内置的“清除历史记录”功能的当前设置值。

要使用此 API,您必须拥有“browsingData” API 权限

类型

browsingData.DataTypeSet

用于指定要删除的数据类型(例如,历史记录、下载、密码等)的对象。

browsingData.RemovalOptions

用于指定要删除数据的追溯时间范围,以及是删除通过普通网页浏览、托管应用或附加组件添加的数据的对象。

方法

browsingData.remove()

删除指定数据类型所对应的浏览数据。

browsingData.removeCache()

清除浏览器的缓存。

browsingData.removeCookies()

删除 cookies。

browsingData.removeDownloads()

删除下载文件列表。

browsingData.removeFormData()

清除已保存的表单数据。

browsingData.removeHistory()

清除浏览器的历史记录。

browsingData.removeLocalStorage()

清除网站创建的任何 本地存储

browsingData.removePasswords()

清除已保存的密码。

browsingData.removePluginData()

清除与插件相关的数据。

browsingData.settings()

获取浏览器“清除历史记录”功能中设置的当前值。

扩展程序示例

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.browsingData API。