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。