browsingData.removeDownloads()
清除浏览器的下载历史记录。请注意,这不会删除已下载对象本身,只会清除浏览器历史记录中的下载记录。
你可以使用 removalOptions
参数(一个 browsingData.RemovalOptions
对象)来:
- 清除在特定时间之后下载的项目的记录
- 控制是仅清除从普通网页下载的项目的记录,还是同时清除从托管应用程序和扩展程序下载的记录。
这是一个返回 Promise
的异步函数。
语法
js
let removing = browser.browsingData.removeDownloads(
removalOptions // RemovalOptions 对象
)
参数
removalOptions
-
object
。一个browsingData.RemovalOptions
对象,可用于仅清除在特定时间之后创建的记录,以及是仅清除从普通网页下载的项目的记录,还是同时清除从托管应用程序和扩展程序下载的记录。
返回值
一个 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
.removeDownloads({ since: oneWeekAgo })
.then(onRemoved, onError);
清除所有下载对象的记录:
js
function onRemoved() {
console.log("已删除");
}
function onError(error) {
console.error(error);
}
browser.browsingData.removeDownloads({}).then(onRemoved, onError);
浏览器兼容性
BCD tables only load in the browser
备注:此 API 基于 Chromium 的 chrome.browsingData
API。