browsingData.removeDownloads()

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

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

  • 清除特定时间之后下载的项目的记录
  • 控制是否仅清除从普通网页下载的项目的记录，或者也清除托管应用和扩展的记录。

这是一个异步函数，它返回一个Promise。

语法

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

参数

removalOptions

object。一个browsingData.RemovalOptions对象，可用于仅清除在给定时间之后创建的记录，以及是否仅清除从普通网页下载的项目的记录或清除托管应用和扩展的记录。

返回值

一个Promise，当删除完成时，它将以无参数的形式完成。如果发生任何错误，则承诺将以错误消息拒绝。

示例

删除过去一周下载的对象的记录

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);

浏览器兼容性

BCD 表仅在浏览器中加载

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