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.DownloadItem的id的integer。
示例
为 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。