downloads.onErased

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

作为参数传递给监听器的,是被删除的 downloads.DownloadItem 对象的 downloadId

语法

js
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 语法

参数

监听器

发生此事件时调用的函数。该函数将接收以下参数:

downloadId

一个代表被删除的 downloads.DownloadItemidinteger

示例

onErased 事件添加一个监听器,然后删除最近一次下载。

js
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。