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。