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。