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()

删除 Cookie。

browsingData.removeDownloads()

删除下载文件列表。

browsingData.removeFormData()

清除保存的表单数据。

browsingData.removeHistory()

清除浏览器的历史记录。

browsingData.removeLocalStorage()

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

browsingData.removePasswords()

清除保存的密码。

browsingData.removePluginData()

清除与插件关联的数据。

browsingData.settings()

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

浏览器兼容性

BCD 表格仅在浏览器中加载

示例扩展

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