browsingData.remove()
移除指定的浏览数据。
要移除的浏览数据在 dataTypes
选项(一个 browsingData.DataTypeSet
对象)中指定。
你可以使用 removalOptions
选项(一个 browsingData.RemovalOptions
对象)来控制移除数据的时间跨度以及是否仅从普通网页中移除数据,还是同时从托管的应用程序和扩展中移除数据。
这是一个返回 Promise
的异步函数。
语法
js
let removing = browser.browsingData.remove(
removalOptions, // RemovalOptions 对象
dataTypes // DataTypeSet 对象
)
参数
removalOptions
-
object
。一个browsingData.RemovalOptions
对象,可用于控制要移除的数据的时间跨度,以及是否从托管的 Web 应用程序和扩展中移除数据,还是仅从普通网页中移除数据。 dataTypes
-
object
。一个browsingData.DataTypeSet
对象,描述要移除的数据类型(例如历史记录、下载等)。
返回值
一个 Promise
,在移除完成时其会兑现且不带任何参数。如果发生任何错误,Promise
将被拒绝,并附带一个错误消息。
示例
删除最近一周的下载历史和浏览历史:
js
function onRemoved() {
console.log("已删除");
}
function onError(error) {
console.error(error);
}
function weekInMilliseconds() {
return 1000 * 60 * 60 * 24 * 7;
}
let oneWeekAgo = new Date().getTime() - weekInMilliseconds();
browser.browsingData
.remove({ since: oneWeekAgo }, { downloads: true, history: true })
.then(onRemoved, onError);
删除所有下载和浏览历史:
js
function onRemoved() {
console.log("已删除");
}
function onError(error) {
console.error(error);
}
browser.browsingData
.remove({}, { downloads: true, history: true })
.then(onRemoved, onError);
示例扩展
浏览器兼容性
BCD tables only load in the browser
备注:
此 API 基于 Chromium 的 chrome.browsingData
API。