browsingData.RemovalOptions

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

类型

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

cookieStoreId 可选

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,表示“所有时间”。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
cookieStoreId
hostnames
originTypes
originTypes.extension
originTypes.protectedWeb
since

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Has more compatibility info.

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