index.md

---

title: downloads.onErased
slug: Mozilla/Add-ons/WebExtensions/API/downloads/onErased
page-type: webextension-api-event
tags:
  - API
  - Add-ons
  - Event
  - Extensions
  - Non-standard
  - Reference
  - WebExtensions
  - downloads
  - onErased
browser-compat: webextensions.api.downloads.onErased

---

{{AddonSidebar()}}

The onErased() event of the {{WebExtAPIRef("downloads")}} API fires when a download is erased from the browser history.

The listener is passed the downloadId of the {{WebExtAPIRef('downloads.DownloadItem')}} object in question as a parameter.

Syntax

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

Events have three functions:

• addListener(callback)

  • : Adds a listener to this event.

• removeListener(listener)

  • : Stop listening to this event. The listener argument is the listener to remove.

• hasListener(listener)

  • : Check whether a given listener is registered for this event. Returns true if it is listening, false otherwise.

addListener syntax

Parameters

• callback

  • : A callback function that will be called when this event occurs. This function will be passed the following arguments:

    • downloadId

      • : An integer representing the id of the {{WebExtAPIRef('downloads.DownloadItem')}} that was erased.

Browser compatibility

{{Compat}}

Examples

Add a listener for onErased events, then erase the most recent download:

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

browser.downloads.onErased.addListener(handleErased);

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

{{WebExtExamples}}

Note: This API is based on Chromium's chrome.downloads API.