downloads.DownloadQuery

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

cookieStoreId Optional

Die Cookie-Store-ID der kontextuellen Identität, in der der Download stattgefunden hat. Weitere Informationen finden Sie unter Arbeiten mit kontextuellen Identitäten.

query Optional

Ein array von strings. Beziehen Sie nur DownloadItems ein, deren filename oder url alle der angegebenen Zeichenfolgen enthält. Sie können auch Begriffe einschließen, die mit einem Minuszeichen (-) beginnen – diese Begriffe dürfen nicht im filename oder url des Elements enthalten sein, damit es einbezogen wird.

startedBefore Optional

Ein DownloadTime. Beziehen Sie nur DownloadItems ein, die vor dem angegebenen Zeitpunkt gestartet wurden.

startedAfter Optional

Ein DownloadTime. Beziehen Sie nur DownloadItems ein, die nach dem angegebenen Zeitpunkt gestartet wurden.

endedBefore Optional

Ein DownloadTime. Beziehen Sie nur DownloadItems ein, die vor dem angegebenen Zeitpunkt beendet wurden.

endedAfter Optional

Ein DownloadTime. Beziehen Sie nur DownloadItems ein, die nach dem angegebenen Zeitpunkt beendet wurden.

totalBytesGreater Optional

Eine number, die eine Anzahl von Bytes darstellt. Beziehen Sie nur DownloadItems ein, deren totalBytes größer als die angegebene Zahl ist.

totalBytesLess Optional

Eine number, die eine Anzahl von Bytes darstellt. Beziehen Sie nur DownloadItems ein, deren totalBytes kleiner als die angegebene Zahl ist.

filenameRegex Optional

Eine string, die einen regulären Ausdruck darstellt. Beziehen Sie nur DownloadItems ein, deren filename-Wert dem angegebenen regulären Ausdruck entspricht.

urlRegex Optional

Eine string, die einen regulären Ausdruck darstellt. Beziehen Sie nur DownloadItems ein, deren url-Wert dem angegebenen regulären Ausdruck entspricht.

limit Optional

Ein integer, der eine Anzahl von Ergebnissen darstellt. Beziehen Sie nur die angegebene Anzahl von DownloadItems ein.

orderBy Optional

Ein array von strings, die DownloadItem-Eigenschaften darstellen, nach denen die Suchergebnisse sortiert werden sollen. Beispielsweise würde das Einfügen von startTime und dann totalBytes in das Array die DownloadItems nach ihrer Startzeit und dann nach totalen Bytes in aufsteigender Reihenfolge sortieren. Um nach einer Eigenschaft in absteigender Reihenfolge zu sortieren, prefixen Sie sie mit einem Bindestrich, zum Beispiel -startTime.

id Optional

Ein integer, der die ID des downloads.DownloadItem darstellt, den Sie abfragen möchten.

url Optional

Eine string, die die absolute URL darstellt, von der der Download initiiert wurde, bevor Weiterleitungen stattfanden.

filename Optional

Ein string, der den absoluten lokalen Pfad der heruntergeladenen Datei darstellt, die Sie abfragen möchten.

danger Optional

Ein string, der einen downloads.DangerType darstellt – beziehen Sie nur DownloadItems mit diesem danger-Wert ein.

mime Optional

Ein string, der einen MIME-Typ darstellt. Beziehen Sie nur DownloadItems mit diesem mime-Wert ein.

startTime Optional

Ein string, das ein Zeitformat nach ISO 8601 darstellt. Beziehen Sie nur DownloadItems mit diesem startTime-Wert ein.

endTime Optional

Ein string, das ein Zeitformat nach ISO 8601 darstellt. Beziehen Sie nur DownloadItems mit diesem endTime-Wert ein.

state Optional

Ein string, der einen Download-downloads.State (in_progress, interrupted oder complete) darstellt. Beziehen Sie nur DownloadItems mit diesem state-Wert ein.

paused Optional

Ein boolean, der angibt, ob ein Download pausiert ist — d.h. das Lesen von Daten vom Host gestoppt wurde, aber die Verbindung (true) offen gehalten wird oder nicht (false). Beziehen Sie nur DownloadItems mit diesem paused-Wert ein.

error Optional

Ein string, der einen downloads.InterruptReason darstellt – einen Grund, warum ein Download unterbrochen wurde. Beziehen Sie nur DownloadItems mit diesem error-Wert ein.

bytesReceived Optional

Eine number, die die Anzahl der bisher vom Host empfangenen Bytes ohne Berücksichtigung der Dateikomprimierung darstellt. Beziehen Sie nur DownloadItems mit diesem bytesReceived-Wert ein.

totalBytes Optional

Eine number, die die Gesamtanzahl der Bytes in der heruntergeladenen Datei ohne Berücksichtigung der Dateikomprimierung darstellt. Beziehen Sie nur DownloadItems mit diesem totalBytes-Wert ein.

fileSize Optional

number. Anzahl der Bytes in der gesamten Datei nach der Dekomprimierung oder -1, wenn unbekannt. Eine number, die die Gesamtanzahl der Bytes in der Datei nach der Dekomprimierung darstellt. Beziehen Sie nur DownloadItems mit diesem fileSize-Wert ein.

exists Optional

Ein boolean, der angibt, ob eine heruntergeladene Datei noch existiert (true) oder nicht (false). Beziehen Sie nur DownloadItems mit diesem exists-Wert ein.