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 将会被拒绝并带有错误消息。
浏览器兼容性
BCD tables only load in the browser
示例
记录当前设置:
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。