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)

Beendet das Lauschen auf dieses Ereignis. Das listener-Argument ist der zu entfernende Listener.

hasListener(listener)

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

addListener-Syntax

Parameter

listener

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

downloadId

Ein integer, der die id des gelöschten downloads.DownloadItem darstellt.

Browser-Kompatibilität

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 der chrome.downloads API von Chromium.