downloads.onErased

当从浏览器历史记录中删除下载时，downloads API 的 onErased() 事件将触发。

侦听器将被传递作为参数的 downloadId，即有问题的 downloads.DownloadItem 对象。

语法

browser.downloads.onErased.addListener(listener)
browser.downloads.onErased.removeListener(listener)
browser.downloads.onErased.hasListener(listener)

事件具有三个函数

addListener(listener): 为该事件添加侦听器。
removeListener(listener): 停止侦听此事件。listener 参数是要删除的侦听器。
hasListener(listener): 检查是否为该事件注册了给定的 listener。如果正在侦听，则返回 true，否则返回 false。

addListener 语法

参数

listener

当此事件发生时调用的函数。此函数将传递此参数

downloadId: 表示已删除的 downloads.DownloadItem 的 id 的 整数。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

为 onErased 事件添加侦听器，然后删除最近的下载

function handleErased(item) {
  console.log(`Erased: ${item}`);
}

browser.downloads.onErased.addListener(handleErased);

let erasing = browser.downloads.erase({
  limit: 1,
  orderBy: ["-startTime"],
});

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