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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
onErased

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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.