browsingData.RemovalOptions
browsingData.RemovalOptions 类型包含用于控制浏览数据删除某些方面的选项。
类型
此类型的值是对象。它们包含以下属性:
-
string。此属性仅适用于 cookie 和 indexedDB 项。删除仅限于属于特定 cookie 存储的项,通过 ID 指定。有关更多信息,请参阅 使用上下文身份。注意: 在 Firefox Nightly 中,还支持通过
cookieStoreId删除 localStorage 项。 excludeOrigin可选-
string数组。要从删除过程中排除的源列表。不能与origins一起使用。仅支持 cookie、存储和缓存。Cookie 会为整个可注册域排除。 hostnames可选-
string数组。此属性适用于 cookie、indexedDB、本地存储和服务工作线程注册项。仅删除与这些主机名关联的 cookie、indexedDB、本地存储和服务工作线程注册项。此处必须只传递主机名,不带协议(例如,
"google.com"而不是"https://google.com")。您可以使用URL接口来解析原始 URL 并检索主机名。与给定主机名的子域关联的项不会被删除:您必须显式列出子域。 origin可选-
string数组。要删除数据的源列表。不能与excludeOrigins一起使用。仅支持 cookie、存储和缓存。Cookie 会为整个可注册域清除。 originTypes可选-
object。用于控制是仅从普通网页删除数据,还是也从托管的 Web 应用和扩展程序删除数据。如果省略此选项,则仅删除来自普通网页(unprotectedWeb)的数据。在从 Web 应用或扩展程序删除数据之前,请务必确保这确实是用户想要的。此对象可以包含以下任何属性
unprotectedWeb可选-
boolean。如果存在且为true,则从普通网页删除数据。 protectedWeb可选-
boolean。如果存在且为true,则从已安装为托管应用的网站删除数据。 extension可选-
boolean。如果存在且为true,则从扩展程序删除数据。
since可选-
number。要删除数据的回溯时间,以自 UNIX 纪元以来的 毫秒数给出。请注意,在删除浏览器缓存时,总是会删除整个缓存,并且会忽略此选项。如果省略since属性,则默认为 0,表示“永远”。
浏览器兼容性
加载中…
注意: 此 API 基于 Chromium 的 chrome.browsingData API。