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()
-
清除浏览器的缓存。
-
删除 Cookie。
browsingData.removeDownloads()
-
删除下载文件列表。
browsingData.removeFormData()
-
清除保存的表单数据。
browsingData.removeHistory()
-
清除浏览器的历史记录。
browsingData.removeLocalStorage()
-
清除网站创建的任何 本地存储。
browsingData.removePasswords()
-
清除保存的密码。
browsingData.removePluginData()
-
清除与插件关联的数据。
browsingData.settings()
-
获取浏览器“清除历史记录”功能中的设置的当前值。
浏览器兼容性
BCD 表格仅在浏览器中加载
示例扩展
注意: 此 API 基于 Chromium 的 chrome.browsingData
API。