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

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

浏览器兼容性

BCD tables only load in the browser

Example extensions

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