browsingData.settings()

浏览器内置了“清除历史记录”功能，用户可以通过此功能清除各种类型的浏览数据。该功能提供了一个用户界面，允许用户选择要删除的数据类型（例如，历史记录、下载等）以及要删除数据的回溯时间。

此函数返回这些设置的当前值。

请注意，并非所有数据类型都始终可以通过用户界面删除，并且某些用户界面选项可能对应多个数据类型。

这是一个异步函数，它返回一个Promise。

语法

let getSettings = browser.browsingData.settings()

参数

无。

返回值

一个Promise，它将解析为一个包含设置信息的对象。此对象具有三个属性

options: browsingData.RemovalOptions。一个RemovalOptions对象，描述当前选择的删除选项。
dataToRemove: browsingData.DataTypeSet。它将包含浏览器 UI 中可切换的每种数据类型的属性。如果该类型被选中用于删除，则每个属性的值为true，否则为false。
dataRemovalPermitted: browsingData.DataTypeSet。它将包含浏览器 UI 中可切换的每种数据类型的属性。如果设备管理员允许用户删除该类型，则每个属性的值为true，否则为false。

如果发生任何错误，则 promise 将被拒绝并显示错误消息。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

记录当前设置

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。