downloads.onChanged

Das onChanged()-Ereignis der downloads API wird ausgelöst, wenn sich eine der Eigenschaften eines downloads.DownloadItem ändert (außer bytesReceived).

Dem Listener wird ein downloadDelta als Parameter übergeben — ein Objekt, das die downloadId des betreffenden downloads.DownloadItem-Objekts enthält, sowie den Status aller Eigenschaften, die sich geändert haben.

Syntax

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

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Stoppt das Zuhören auf dieses Ereignis. 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 es zuhört, false andernfalls.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Dieser Funktion wird folgendes Argument übergeben:

downloadDelta: Ein object, das das geänderte downloads.DownloadItem-Objekt und den Status aller darin geänderten Eigenschaften darstellt. Siehe den Abschnitt downloadDelta für weitere Details.

Zusätzliche Objekte

downloadDelta

Das downloadDelta-Objekt hat die folgenden verfügbaren Eigenschaften:

id: Ein integer, der die id des geänderten downloads.DownloadItem darstellt.
url Optional: Ein downloads.StringDelta-Objekt, das eine Änderung in der url eines downloads.DownloadItem beschreibt.
filename Optional: Ein downloads.StringDelta-Objekt, das eine Änderung im filename eines downloads.DownloadItem beschreibt.
danger Optional: Ein downloads.StringDelta-Objekt, das eine Änderung in der danger eines downloads.DownloadItem beschreibt.
mime Optional: Ein downloads.StringDelta-Objekt, das eine Änderung im mime eines downloads.DownloadItem beschreibt.
startTime Optional: Ein downloads.StringDelta-Objekt, das eine Änderung in der startTime eines downloads.DownloadItem beschreibt.
endTime Optional: Ein downloads.StringDelta-Objekt, das eine Änderung in der endTime eines downloads.DownloadItem beschreibt.
state Optional: Ein downloads.StringDelta-Objekt, das eine Änderung im state eines downloads.DownloadItem beschreibt.
canResume Optional: Ein downloads.BooleanDelta-Objekt, das eine Änderung im canResume-Status eines downloads.DownloadItem beschreibt.
paused Optional: Ein downloads.BooleanDelta-Objekt, das eine Änderung im paused-Status eines downloads.DownloadItem beschreibt.
error Optional: Ein downloads.StringDelta-Objekt, das eine Änderung im error-Status eines downloads.DownloadItem beschreibt.
totalBytes Optional: Ein downloads.DoubleDelta-Objekt, das eine Änderung in den totalBytes eines downloads.DownloadItem beschreibt.
fileSize Optional: Ein downloads.DoubleDelta-Objekt, das eine Änderung in der fileSize eines downloads.DownloadItem beschreibt.
exists Optional: Ein downloads.BooleanDelta-Objekt, das eine Änderung im exists-Status eines downloads.DownloadItem beschreibt.

Beispiele

Protokollieren Sie eine Nachricht, wenn Downloads abgeschlossen sind:

function handleChanged(delta) {
  if (delta.state && delta.state.current === "complete") {
    console.log(`Download ${delta.id} has completed.`);
  }
}

browser.downloads.onChanged.addListener(handleChanged);

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.downloads-API von Chromium.

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden