browsingData.removeDownloads()

清除浏览器的下载记录。请注意,这不会删除下载的文件本身,只删除浏览器历史记录中的下载记录。

您可以使用 removalOptions 参数,它是一个 browsingData.RemovalOptions 对象,用于

  • 清除给定时间之后下载的项目的记录
  • 控制是仅清除来自普通网页下载的项目的记录,还是同时清除来自托管应用和扩展程序的记录。

这是一个异步函数,返回一个 Promise

语法

js
let removing = browser.browsingData.removeDownloads(
  removalOptions            // RemovalOptions object
)

参数

removalOptions

object。一个 browsingData.RemovalOptions 对象,可用于仅清除在给定时间之后创建的记录,以及控制是仅清除来自普通网页下载的项目的记录,还是同时清除来自托管应用和扩展程序的记录。

返回值

一个 Promise,当移除完成后,它将不带参数地被 fulfilled。如果发生任何错误,该 Promise 将会使用错误消息被 rejected。

示例

删除过去一周下载的项目的记录

js
function onRemoved() {
  console.log("removed");
}

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("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeDownloads({}).then(onRemoved, onError);

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.browsingData API。