downloads.DownloadQuery

Typ

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. Schließen Sie nur DownloadItems ein, deren filename oder url alle 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 eingeschlossen wird.

startedBefore Optional

Ein DownloadTime. Schließen Sie nur DownloadItems ein, die vor dem angegebenen Zeitpunkt gestartet wurden.

startedAfter Optional

Ein DownloadTime. Schließen Sie nur DownloadItems ein, die nach dem angegebenen Zeitpunkt gestartet wurden.

endedBefore Optional

Ein DownloadTime. Schließen Sie nur DownloadItems ein, die vor dem angegebenen Zeitpunkt beendet wurden.

endedAfter Optional

Ein DownloadTime. Schließen Sie nur DownloadItems ein, die nach dem angegebenen Zeitpunkt beendet wurden.

totalBytesGreater Optional

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

totalBytesLess Optional

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

filenameRegex Optional

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

urlRegex Optional

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

limit Optional

Ein integer, der eine Anzahl von Ergebnissen darstellt. Schließen 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. Zum Beispiel würde das Hinzufügen von startTime und dann totalBytes zum Array die DownloadItems nach Startzeit und dann Gesamtbytes sortieren — in aufsteigender Reihenfolge. Um die Sortierung nach einer Eigenschaft in absteigender Reihenfolge anzugeben, präfixen Sie sie mit einem Minuszeichen, 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, 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 einen downloads.DangerType darstellt — schließen Sie nur DownloadItems mit diesem danger-Wert ein.

mime Optional

Eine string, die einen MIME-Typ darstellt. Schließen Sie nur DownloadItems mit diesem mime-Wert ein.

startTime Optional

Eine string, die eine Zeit im ISO 8601-Format darstellt. Schließen Sie nur DownloadItems mit diesem startTime-Wert ein.

endTime Optional

Eine string, die eine Zeit im ISO 8601-Format darstellt. Schließen Sie nur DownloadItems mit diesem endTime-Wert ein.

state Optional

Eine string, die einen Download-downloads.State (in_progress, interrupted, oder complete) darstellt. Schließen Sie nur DownloadItems mit diesem state-Wert ein.

paused Optional

Ein boolean, der angibt, ob ein Download angehalten ist — d.h. das Lesen von Daten vom Host gestoppt hat, die Verbindung jedoch offen gehalten hat (true), oder nicht (false). Schließen Sie nur DownloadItems mit diesem paused-Wert ein.

error Optional

Eine string, die einen downloads.InterruptReason darstellt — ein Grund, warum ein Download unterbrochen wurde. Schließen Sie nur DownloadItems mit diesem error-Wert ein.

bytesReceived Optional

Eine number, die die Anzahl der bisher vom Host empfangenen Bytes darstellt, ohne Datei-Komprimierung zu berücksichtigen. Schließen Sie nur DownloadItems mit diesem bytesReceived-Wert ein.

totalBytes Optional

Eine number, die die Gesamtanzahl an Bytes in der heruntergeladenen Datei darstellt, ohne Datei-Komprimierung zu berücksichtigen. Schließen Sie nur DownloadItems mit diesem totalBytes-Wert ein.

fileSize Optional

number. Anzahl der Bytes in der gesamten Datei nach Dekompression, oder -1, wenn unbekannt. Eine number, die die Gesamtanzahl an Bytes in der Datei nach der Dekompression darstellt. Schließen Sie nur DownloadItems mit diesem fileSize-Wert ein.

exists Optional

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

Browser-Kompatibilität