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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
downloads
BooleanDelta
DangerType
DoubleDelta
DownloadQuery
DownloadQuery.bytesReceived
DownloadQuery.cookieStoreId
DownloadQuery.danger
DownloadQuery.endTime
DownloadQuery.endedAfter
DownloadQuery.endedBefore
DownloadQuery.error
DownloadQuery.exists
DownloadQuery.fileSize
DownloadQuery.filename
DownloadQuery.filenameRegex
DownloadQuery.id
DownloadQuery.limit
DownloadQuery.mime
DownloadQuery.orderBy
DownloadQuery.paused
DownloadQuery.query
DownloadQuery.startTime
DownloadQuery.startedAfter
DownloadQuery.startedBefore
DownloadQuery.state
DownloadQuery.totalBytes
DownloadQuery.totalBytesGreater
DownloadQuery.totalBytesLess
DownloadQuery.url
DownloadQuery.urlRegex
DownloadTime
FilenameConflictAction
FilenameConflictAction.prompt
InterruptReason
State
StringDelta
acceptDanger
cancel
download
download.allowHttpErrors
download.body
download.conflictAction
download.cookieStoreId
download.filename
download.headers
download.incognito
download.method
download.saveAs
erase
getFileIcon
onChanged
onCreated
onErased
open
pause
removeFile
resume
search
setShelfEnabled
show
showDefaultFolder

Legend

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

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
Uses a non-standard name.
Has more compatibility info.

Beispielerweiterungen

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