browsingData.RemovalOptions
browsingData.RemovalOptions
类型包含控制浏览数据删除的某些方面的选项。
类型
此类型的值是对象。它们包含以下属性:
-
string
。此属性只适用于 cookie 和 indexedDB 项。删除仅限于通过 ID 指定的 cookie 存储中的项目。有关更多信息,请参见使用场景身份。备注:Firefox Nightly 还支持通过
cookieStoreId
删除 localStorage 项目。 hostnames
可选-
string
数组。此属性适用于 cookie、indexedDB、本地存储和 service worker 注册项。仅删除与这些主机名关联的 cookie、indexedDB、本地存储和 service worker 注册项。这里必须传递不带协议的主机名(例如,
"google.com"
而不是"https://google.com"
)。你可以使用URL
接口来解析原始 URL 并检索主机名。与给定主机名的子域关联的项目不会被删除:你必须显式列出子域。 originTypes
可选-
object
。用于控制是仅从普通网页中删除数据,还是也从托管的 Web 应用程序和扩展中删除数据。如果省略此选项,则仅删除来自普通网页("unprotectedWeb"
)的数据。在删除来自 Web 应用程序或扩展的数据之前,请务必保持谨慎,以确保这确实是用户想要的。此对象可以包含以下任何属性:
unprotectedWeb
可选-
boolean
。如果存在且为true
,则从普通网页中删除数据。 protectedWeb
可选-
boolean
。如果存在且为true
,则从已安装为托管应用程序的网站中删除数据。 extension
可选-
boolean
。如果存在且为true
,则从扩展中删除数据。
since
可选-
number
。从何时开始删除数据,以自纪元以来的毫秒数表示。请注意,在删除浏览器缓存时,将始终删除整个缓存,此选项将被忽略。如果省略since
属性,则默认为 0,表示“所有时间”。
浏览器兼容性
BCD tables only load in the browser
备注:此 API 基于 Chromium 的 chrome.browsingData
API。