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。