downloads.DownloadQuery
Der DownloadQuery
-Typ der downloads
API definiert eine Reihe von Parametern, die verwendet werden können, um im Download-Manager nach einem spezifischen Satz von Downloads zu suchen.
Dieser Typ wird beispielsweise in downloads.search()
und downloads.erase()
als Abfrageobjekt verwendet, um die Menge der DownloadItems
zu filtern, die zurückgegeben oder gelöscht werden sollen.
Typ
Werte dieses Typs sind Objekte. Sie enthalten folgende Eigenschaften:
-
Die Cookie-Store-ID der kontextbezogenen Identität, in der der Download stattgefunden hat. Siehe Arbeiten mit kontextbezogenen Identitäten für mehr Informationen.
query
Optional-
Ein
array
vonstring
s. Schließen Sie nur dieDownloadItems
ein, derenfilename
oderurl
alle angegebenen Zeichenfolgen enthalten. Sie können auch Begriffe hinzufügen, die mit einem Bindestrich (-) beginnen — diese Begriffe dürfen nicht imfilename
oder derurl
des Elements enthalten sein, damit es eingeschlossen wird. startedBefore
Optional-
Ein
DownloadTime
. Schließen Sie nur dieDownloadItems
ein, die vor der angegebenen Zeit begonnen haben. startedAfter
Optional-
Ein
DownloadTime
. Schließen Sie nur dieDownloadItems
ein, die nach der angegebenen Zeit begonnen haben. endedBefore
Optional-
Ein
DownloadTime
. Schließen Sie nur dieDownloadItems
ein, die vor der angegebenen Zeit beendet wurden. endedAfter
Optional-
Ein
DownloadTime
. Schließen Sie nur dieDownloadItems
ein, die nach der angegebenen Zeit beendet wurden. totalBytesGreater
Optional-
Eine
number
, die eine Anzahl von Bytes darstellt. Schließen Sie nur dieDownloadItems
ein, derentotalBytes
größer ist als die angegebene Zahl. totalBytesLess
Optional-
Eine
number
, die eine Anzahl von Bytes darstellt. Schließen Sie nur dieDownloadItems
ein, derentotalBytes
kleiner ist als die angegebene Zahl. filenameRegex
Optional-
Eine
string
, die einen regulären Ausdruck darstellt. Schließen Sie nur dieDownloadItems
ein, derenfilename
-Wert mit dem angegebenen regulären Ausdruck übereinstimmt. urlRegex
Optional-
Eine
string
, die einen regulären Ausdruck darstellt. Schließen Sie nur dieDownloadItems
ein, derenurl
-Wert mit dem angegebenen regulären Ausdruck übereinstimmt. limit
Optional-
Ein
integer
, der eine Anzahl von Ergebnissen darstellt. Schließen Sie nur die angegebene Anzahl vonDownloadItems
ein. orderBy
Optional-
Ein
array
vonstring
s, dieDownloadItem
-Eigenschaften darstellen, nach denen die Suchergebnisse sortiert werden sollen. Beispielsweise würde das Einschließen vonstartTime
und danntotalBytes
in das Array dieDownloadItems
nach ihrer Startzeit und dann nach den gesamten Bytes sortieren — in aufsteigender Reihenfolge. Um die Sortierung nach einer Eigenschaft in absteigender Reihenfolge anzugeben, fügen Sie ihr ein Minuszeichen voran, zum Beispiel-startTime
. id
Optional-
Ein
integer
, der die ID desdownloads.DownloadItem
darstellt, den Sie abfragen möchten. url
Optional-
Eine
string
, die die absolute URL repräsentiert, von der der Download initiiert wurde, vor jeglichen Umleitungen. filename
Optional-
Eine
string
, die den absoluten lokalen Pfad der Download-Datei darstellt, die Sie abfragen möchten. danger
Optional-
Eine
string
, die einendownloads.DangerType
darstellt — schließen Sie nur dieDownloadItems
mit diesemdanger
-Wert ein. mime
Optional-
Eine
string
, die einen MIME-Typ darstellt. Schließen Sie nur dieDownloadItems
mit diesemmime
-Wert ein. startTime
Optional-
Eine
string
, die eine Zeit im ISO 8601-Format darstellt. Schließen Sie nur dieDownloadItems
mit diesemstartTime
-Wert ein. endTime
Optional-
Eine
string
, die eine Zeit im ISO 8601-Format darstellt. Wird aufDownloadItems
mit diesemendTime
-Wert beschränkt. state
Optional-
Eine
string
, die einen Download-downloads.State
darstellt (in_progress
,interrupted
odercomplete
). Schließen Sie nur dieDownloadItems
mit diesemstate
-Wert ein. paused
Optional-
Ein
boolean
, der angibt, ob ein Download pausiert ist — d.h. das Lesen von Daten vom Host gestoppt wurde, die Verbindung jedoch offen blieb (true
) oder nicht (false
). Schließen Sie nur dieDownloadItems
mit diesempaused
-Wert ein. error
Optional-
Eine
string
, die einendownloads.InterruptReason
darstellt — ein Grund, warum ein Download unterbrochen wurde. Schließen Sie nur dieDownloadItems
mit diesemerror
-Wert ein. bytesReceived
Optional-
Eine
number
, die die Anzahl der bisher vom Host empfangenen Bytes ohne Berücksichtigung der Dateikomprimierung darstellt. Schließen Sie nur dieDownloadItems
mit diesembytesReceived
-Wert ein. totalBytes
Optional-
Eine
number
, die die Gesamtanzahl der Bytes in der heruntergeladenen Datei ohne Berücksichtigung der Dateikomprimierung darstellt. Schließen Sie nur dieDownloadItems
mit diesemtotalBytes
-Wert ein. fileSize
Optional-
number
. Anzahl der Bytes in der gesamten Datei nach der Dekomprimierung oder -1, wenn unbekannt. Einenumber
, die die Gesamtanzahl der Bytes in der Datei nach der Dekomprimierung darstellt. Schließen Sie nur dieDownloadItems
mit diesemfileSize
-Wert ein. exists
Optional-
Ein
boolean
, der angibt, ob eine heruntergeladene Datei noch existiert (true
) oder nicht (false
). Schließen Sie nur dieDownloadItems
mit diesemexists
-Wert ein.
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Diese API basiert auf der chrome.downloads
API von Chromium.