browsingData.settings()
瀏覽器內建的“清除歷史記錄”功能,允許使用者清除各種型別的瀏覽資料。該功能提供了一個使用者介面,使用者可以在其中選擇要刪除的資料型別(例如,歷史記錄、下載記錄等)以及刪除資料的回溯時間。
此函式返回這些設定的當前值。
請注意,並非所有資料型別都始終可以透過使用者介面刪除,並且某些使用者介面選項可能對應於一種以上的資料型別。
這是一個非同步函式,返回一個 Promise。
語法
js
let getSettings = browser.browsingData.settings()
引數
無。
返回值
一個 Promise,它將以包含設定資訊的物件進行解析。該物件有三個屬性
options-
browsingData.RemovalOptions。一個RemovalOptions物件,描述當前選擇的移除選項。 dataToRemove-
browsingData.DataTypeSet。它將包含瀏覽器使用者介面中可切換的每種資料型別的屬性。如果選擇了該型別進行移除,則對應屬性值為true,否則為false。 dataRemovalPermitted-
browsingData.DataTypeSet。它將包含瀏覽器使用者介面中可切換的每種資料型別的屬性。如果裝置管理員允許使用者移除該型別,則對應屬性值為true,否則為false。
如果發生任何錯誤,Promise 將以錯誤訊息被拒絕。
示例
記錄當前設定
js
function onGotSettings(settings) {
console.log(settings.options);
console.log(settings.dataToRemove);
console.log(settings.dataRemovalPermitted);
}
function onError(error) {
console.error(error);
}
browser.browsingData.settings().then(onGotSettings, onError);
瀏覽器相容性
載入中…
注意: 此 API 基於 Chromium 的 chrome.browsingData API。