browsingData.RemovalOptions

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

类型

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

cookieStoreId 可选

string。此属性仅适用于 cookie 和 indexedDB 项。删除仅限于属于特定 cookie 存储 的项,由 ID 指定。有关更多信息,请参阅 使用上下文标识

注意:在 Firefox Nightly 中,也支持通过 cookieStoreId 删除 localStorage 项。

hostnames 可选

stringArray。此属性适用于 cookie、indexedDB、本地存储和服务工作者注册项。仅删除与这些主机名关联的 cookie、indexedDB、本地存储和服务工作者注册项。

您必须在此处传入主机名,不带协议(例如,"google.com" 而不是 "https://google.com")。您可以使用 URL 接口解析原始 URL 并检索主机名。与给定主机名的子域关联的项不会被删除:您必须显式列出子域。

originTypes 可选

object。用于控制是否仅从普通网页删除数据,还是还从托管 Web 应用和扩展程序中删除数据。如果省略此选项,则仅删除来自普通网页(“unprotectedWeb”)的数据。在从 Web 应用或扩展程序中删除数据之前,请务必仔细确保这确实是用户想要的。

此对象可能包含以下任何属性

unprotectedWeb 可选

boolean。如果存在且为 true,则删除来自普通网页的数据。

protectedWeb 可选

boolean。如果存在且为 true,则删除已安装为托管应用的网站的数据。

extension 可选

boolean。如果存在且为 true,则删除来自扩展程序的数据。

since 可选

number。要删除数据的时间范围,以自 Unix 纪元以来的毫秒数为单位。请注意,在删除浏览器缓存时,始终会删除整个缓存,并且会忽略此选项。如果省略 since 属性,则默认为 0,这意味着“永远”。

浏览器兼容性

BCD 表格仅在浏览器中加载

注意:此 API 基于 Chromium 的 chrome.browsingData API。