browsingData

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

browsingData API 中,浏览数据被分为以下类型:

  • 浏览器缓存
  • cookie
  • 下载
  • 历史记录
  • 本地存储
  • 插件数据
  • 已保存的表单数据
  • 已保存的密码

你可以使用 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()

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

浏览器兼容性

示例扩展

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