downloads

Ermöglicht Erweiterungen die Interaktion mit dem Download-Manager des Browsers. Sie können dieses API-Modul verwenden, um Dateien herunterzuladen, Downloads abzubrechen, anzuhalten, fortzusetzen und heruntergeladene Dateien im Dateimanager anzuzeigen.

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

Typen

downloads.FilenameConflictAction: Definiert Optionen, was zu tun ist, wenn der Name einer heruntergeladenen Datei mit einer bestehenden 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 über mögliche Gefahren im Zusammenhang mit herunterladbaren Dateien.
downloads.State: Definiert verschiedene Zustände, in denen sich ein aktueller Download befinden kann.
downloads.DownloadItem: Stellt eine heruntergeladene Datei dar.
downloads.StringDelta: Stellt den Unterschied zwischen zwei Zeichenketten dar.
downloads.DoubleDelta: Stellt den Unterschied zwischen zwei Gleitkommazahlen dar.
downloads.BooleanDelta: Stellt den Unterschied zwischen zwei booleschen Werten dar.
downloads.DownloadTime: Stellt die Zeit dar, die ein Download zum Abschluss benötigt hat.
downloads.DownloadQuery: Definiert eine Reihe von Parametern, die verwendet werden können, um den Download-Manager nach einer bestimmten Reihe von Downloads zu durchsuchen.

Funktionen

downloads.download(): Lädt eine Datei herunter, gegeben ihrer URL und anderen optionalen Einstellungen.
downloads.search(): Durchsucht die im Download-Manager des Browsers verfügbaren DownloadItems und gibt jene zurück, die den angegebenen Suchkriterien entsprechen.
downloads.pause(): Hält einen Download an.
downloads.resume(): Setzt einen angehaltenen Download fort.
downloads.cancel(): Bricht einen Download ab.
downloads.getFileIcon(): Ruft ein Symbol für den angegebenen Download ab.
downloads.open(): Öffnet die heruntergeladene Datei mit der zugeordneten Anwendung.
downloads.show(): Öffnet die Dateimanager-Anwendung der Plattform, um die heruntergeladene Datei im enthaltenden Ordner anzuzeigen.
downloads.showDefaultFolder(): Öffnet die Dateimanager-Anwendung der Plattform, um den Standard-Download-Ordner anzuzeigen.
downloads.erase(): Löscht übereinstimmende DownloadItems aus dem Download-Verlauf des Browsers, ohne die heruntergeladenen Dateien von der Festplatte zu entfernen.
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.

Beispielerweiterungen

latest-download

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