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。