browsingData.settings()

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

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

请注意，并非所有数据类型都可以通过用户界面删除，某些用户界面选项可能映射到多个数据类型。

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

语法

let getSettings = browser.browsingData.settings()

参数

无。

返回值

一个 Promise，当成功时其会兑现一个包含设置信息的对象。该对象有三个属性：

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

如果发生任何错误，Promise 将会被拒绝并带有错误消息。

浏览器兼容性

BCD tables only load in the browser

示例

记录当前设置：

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);