downloads.onErased

Das onErased()-Ereignis der downloads API wird ausgelöst, wenn ein Download aus dem Browserverlauf gelöscht wird.

Der Listener erhält die downloadId des betreffenden downloads.DownloadItem-Objekts als Parameter.

Syntax

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

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Hört auf, diesem Ereignis zuzuhören. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob ein gegebener listener für dieses Ereignis registriert ist. Gibt true zurück, wenn er zuhört, false sonst.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Diese Funktion erhält das folgende Argument:

downloadId

Eine integere Zahl, die die id des gelöschten downloads.DownloadItem darstellt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Fügen Sie einen Listener für onErased-Ereignisse hinzu und löschen Sie dann den neuesten Download:

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

browser.downloads.onErased.addListener(handleErased);

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

Hinweis: Diese API basiert auf Chromiums chrome.downloads API.