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 stattfand. Weitere Informationen finden Sie unter Arbeiten mit kontextuellen Identitäten.

query Optional

Ein array von strings. Nur DownloadItems einschließen, 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. Nur DownloadItems einschließen, die vor der angegebenen Zeit gestartet wurden.

startedAfter Optional

Ein DownloadTime. Nur DownloadItems einschließen, die nach der angegebenen Zeit gestartet wurden.

endedBefore Optional

Ein DownloadTime. Nur DownloadItems einschließen, die vor der angegebenen Zeit beendet wurden.

endedAfter Optional

Ein DownloadTime. Nur DownloadItems einschließen, die nach der angegebenen Zeit beendet wurden.

totalBytesGreater Optional

Eine number, die eine Anzahl von Bytes darstellt. Nur DownloadItems einschließen, deren totalBytes größer als die angegebene Zahl ist.

totalBytesLess Optional

Eine number, die eine Anzahl von Bytes darstellt. Nur DownloadItems einschließen, deren totalBytes kleiner als die angegebene Zahl ist.

filenameRegex Optional

Eine string, die einen regulären Ausdruck darstellt. Nur DownloadItems einschließen, deren filename-Wert dem angegebenen regulären Ausdruck entspricht.

urlRegex Optional

Eine string, die einen regulären Ausdruck darstellt. Nur DownloadItems einschließen, deren url-Wert dem angegebenen regulären Ausdruck entspricht.

limit Optional

Ein integer, der eine Anzahl von Ergebnissen darstellt. Nur die angegebene Anzahl von DownloadItems einschließen.

orderBy Optional

Ein array von strings, die DownloadItem-Eigenschaften darstellen, nach denen die Suchergebnisse sortiert werden sollen. Wenn Sie zum Beispiel startTime und dann totalBytes im Array einschließen, werden die DownloadItems nach ihrer Startzeit und dann nach der Gesamtbytezahl in aufsteigender Reihenfolge sortiert. Um die Sortierung nach einer Eigenschaft in absteigender Reihenfolge anzugeben, stellen Sie ihr ein Minuszeichen voran, 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 aus der Download initiiert wurde, noch vor allen Weiterleitungen.

filename Optional

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

danger Optional

Eine Zeichenfolge, die einen downloads.DangerType darstellt — nur DownloadItems mit diesem danger-Wert einschließen.

mime Optional

Ein string, der einen MIME-Typ darstellt. Nur DownloadItems mit diesem mime-Wert einschließen.

startTime Optional

Eine string, die eine Zeit im ISO 8601-Format darstellt. Nur DownloadItems mit diesem startTime-Wert einschließen.

endTime Optional

Eine string, die eine Zeit im ISO 8601-Format darstellt. Nur auf DownloadItems mit diesem endTime-Wert beschränkt.

state Optional

Ein string, der einen Download-downloads.State (in_progress, interrupted oder complete) darstellt. Nur DownloadItems mit diesem state-Wert einschließen.

paused Optional

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

error Optional

Eine Zeichenfolge, die einen downloads.InterruptReason darstellt — einen Grund, warum ein Download unterbrochen wurde. Nur DownloadItems mit diesem error-Wert einschließen.

bytesReceived Optional

Eine number, die die Anzahl der bisher vom Host empfangenen Bytes darstellt, ohne dabei die Datei-Kompression zu berücksichtigen. Nur DownloadItems mit diesem bytesReceived-Wert einschließen.

totalBytes Optional

Eine number, die die Gesamtanzahl der Bytes in der heruntergeladenen Datei darstellt, ohne dabei die Datei-Kompression zu berücksichtigen. Nur DownloadItems mit diesem totalBytes-Wert einschließen.

fileSize Optional

number. Anzahl der Bytes in der gesamten Datei nach Dekomprimierung oder -1, wenn unbekannt. Eine number, die die Gesamtanzahl der Bytes in der Datei nach der Dekomprimierung darstellt. Nur DownloadItems mit diesem fileSize-Wert einschließen.

exists Optional

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

Browser-Kompatibilität