browsingData.RemovalOptions

browsingData.RemovalOptions 类型包含用于控制浏览数据删除某些方面的选项。

类型

此类型的值是对象。它们包含以下属性:

cookieStoreId 可选

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。