downloads

Ermöglicht Erweiterungen, mit dem Download-Manager des Browsers zu interagieren. Sie können dieses API-Modul verwenden, um Dateien herunterzuladen, Downloads zu stornieren, zu pausieren, fortzusetzen und heruntergeladene Dateien im Dateimanager anzuzeigen.

Um diese API zu verwenden, müssen Sie die "downloads" API-Berechtigung in Ihrer manifest.json Datei angegeben haben.

Typen

downloads.FilenameConflictAction: Definiert Optionen, was zu tun ist, wenn der Name einer heruntergeladenen Datei mit einer vorhandenen Datei in Konflikt steht.
downloads.InterruptReason: Definiert eine Reihe möglicher Gründe, warum ein Download unterbrochen wurde.
downloads.DangerType: Definiert eine Reihe von häufigen Warnungen vor möglichen Gefahren, die mit herunterladbaren Dateien verbunden sind.
downloads.State: Definiert verschiedene Zustände, in denen sich ein aktueller Download befinden kann.
downloads.DownloadItem: Repräsentiert eine heruntergeladene Datei.
downloads.StringDelta: Repräsentiert den Unterschied zwischen zwei Zeichenfolgen.
downloads.DoubleDelta: Repräsentiert den Unterschied zwischen zwei Fließkommazahlen.
downloads.BooleanDelta: Repräsentiert den Unterschied zwischen zwei booleschen Werten.
downloads.DownloadTime: Repräsentiert die Zeit, die ein Download zum Abschließen benötigt hat.
downloads.DownloadQuery: Definiert eine Reihe von Parametern, die verwendet werden können, um im Download-Manager nach einem bestimmten Satz von Downloads zu suchen.

Funktionen

downloads.download(): Lädt eine Datei herunter, basierend auf ihrer URL und anderen optionalen Präferenzen.
downloads.search(): Durchsucht die im Download-Manager des Browsers verfügbaren DownloadItems und gibt diejenigen zurück, die den angegebenen Suchkriterien entsprechen.
downloads.pause(): Pausiert einen Download.
downloads.resume(): Setzt einen pausierten Download fort.
downloads.cancel(): Storniert einen Download.
downloads.getFileIcon(): Ruft ein Symbol für den angegebenen Download ab.
downloads.open(): Öffnet die heruntergeladene Datei mit ihrer zugehörigen Anwendung.
downloads.show(): Öffnet die Dateimanager-Anwendung der Plattform, um die heruntergeladene Datei im enthaltenen Ordner anzuzeigen.
downloads.showDefaultFolder(): Öffnet die Dateimanager-Anwendung der Plattform, um den Standard-Download-Ordner anzuzeigen.
downloads.erase(): Löscht passende DownloadItems aus dem Download-Verlauf des Browsers, ohne die heruntergeladenen Dateien von der Festplatte zu löschen.
downloads.removeFile(): Entfernt eine heruntergeladene Datei von der Festplatte, aber nicht aus dem Download-Verlauf des Browsers.
downloads.acceptDanger(): Fordert den Benutzer auf, einen gefährlichen Download zu akzeptieren oder abzubrechen.
downloads.setShelfEnabled(): Aktiviert oder deaktiviert das graue Regal am unteren Rand jedes Fensters, das mit dem aktuellen Browser-Profil verknüpft ist. Das Regal bleibt deaktiviert, solange mindestens eine Erweiterung es deaktiviert hat.

Ereignisse

downloads.onCreated: Wird mit dem DownloadItem-Objekt ausgelöst, wenn ein Download beginnt.
downloads.onErased: Wird mit der downloadId ausgelöst, wenn ein Download aus dem Verlauf gelöscht wird.
downloads.onChanged: Wenn sich eine der Eigenschaften eines DownloadItem außer bytesReceived ändert, wird dieses Ereignis mit der downloadId und einem Objekt ausgelöst, das die geänderten Eigenschaften enthält.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiel-Erweiterungen

latest-download

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