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:

cookieStoreId Optional

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 von strings. Schließen Sie nur die DownloadItems ein, deren filename oder url alle angegebenen Zeichenfolgen enthalten. Sie können auch Begriffe hinzufügen, die mit einem Bindestrich (-) beginnen — diese Begriffe dürfen nicht im filename oder der url des Elements enthalten sein, damit es eingeschlossen wird.

startedBefore Optional

Ein DownloadTime. Schließen Sie nur die DownloadItems ein, die vor der angegebenen Zeit begonnen haben.

startedAfter Optional

Ein DownloadTime. Schließen Sie nur die DownloadItems ein, die nach der angegebenen Zeit begonnen haben.

endedBefore Optional

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

endedAfter Optional

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

totalBytesGreater Optional

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

totalBytesLess Optional

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

filenameRegex Optional

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

urlRegex Optional

Eine string, die einen regulären Ausdruck darstellt. Schließen Sie nur die DownloadItems ein, deren url-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 von DownloadItems ein.

orderBy Optional

Ein array von strings, die DownloadItem-Eigenschaften darstellen, nach denen die Suchergebnisse sortiert werden sollen. Beispielsweise würde das Einschließen von startTime und dann totalBytes in das Array die DownloadItems 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 des downloads.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 einen downloads.DangerType darstellt — schließen Sie nur die DownloadItems mit diesem danger-Wert ein.

mime Optional

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

startTime Optional

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

endTime Optional

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

state Optional

Eine string, die einen Download-downloads.State darstellt (in_progress, interrupted oder complete). Schließen Sie nur die 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, die Verbindung jedoch offen blieb (true) oder nicht (false). Schließen Sie nur die 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 die 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. Schließen Sie nur die 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. Schließen Sie nur die 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. Schließen Sie nur die 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 die DownloadItems mit diesem exists-Wert ein.

Browser-Kompatibilität

BCD tables only load in the browser

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