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()
-
清除浏览器的缓存。
-
移除 cookie。
browsingData.removeDownloads()
-
移除下载文件列表。
browsingData.removeFormData()
-
清除已保存的表单数据。
browsingData.removeHistory()
-
清除浏览器的历史记录。
browsingData.removeLocalStorage()
-
清除网站创建的任何本地存储。
browsingData.removePasswords()
-
清除已保存的密码。
browsingData.removePluginData()
-
清除与插件相关的数据。
browsingData.settings()
-
获取浏览器“清除历史记录”特性的当前设置值。
浏览器兼容性
BCD tables only load in the browser
示例扩展
备注:此 API 基于 Chromium 的 chrome.browsingData
API。