downloads.DownloadQuery
Тип DownloadQuery API downloads определяет набор параметров, которые могут быть использованы для поиска в диспетчере загрузок конкретного набора загрузок.
Этот тип используется, например, в downloads.search() и downloads.erase(), в качестве объекта запроса для фильтрации набора DownloadItems, которые нужно вернуть или удалить.
Тип
Значения этого типа представляют собой объекты. Они содержат следующие свойства:
-
Идентификатор хранилища cookie контекстуальной личности, в которой произошла загрузка.
-
queryНеобязательно -
Массив строк. Включаются только
DownloadItems, чьи поляfilenameилиurlсодержат все указанные строки. Вы также можете включить термины, начинающиеся с тире (-) — эти термины не должны содержаться в поляхfilenameилиurlэлемента, чтобы он был включён. -
startedBeforeНеобязательно -
DownloadTime. Включаются толькоDownloadItems, начатые до указанного времени. -
startedAfterНеобязательно -
DownloadTime. Включаются толькоDownloadItems, начатые после указанного времени. -
endedBeforeНеобязательно -
DownloadTime. Включаются толькоDownloadItems, завершённые до указанного времени. -
endedAfterНеобязательно -
DownloadTime. Включаются толькоDownloadItems, завершённые после указанного времени. -
totalBytesGreaterНеобязательно -
Число байтов. Включаются только
DownloadItems, чьи значенияtotalBytesбольше указанного числа. -
totalBytesLessНеобязательно -
Число байтов. Включаются только
DownloadItems, чьи значенияtotalBytesменьше указанного числа. -
filenameRegexНеобязательно -
Регулярное выражение. Включаются только
DownloadItems, чьи значенияfilenameсоответствуют данному регулярному выражению. -
urlRegexНеобязательно -
Регулярное выражение. Включаются только
DownloadItems, чьи значенияurlсоответствуют данному регулярному выражению. -
limitНеобязательно -
Число результатов. Включаются только указанное количество
DownloadItems. -
orderByНеобязательно -
Массив свойств
DownloadItem, по которым должны быть отсортированы результаты поиска. Например, включениеstartTimeиtotalBytesв массив отсортируетDownloadItemsпо времени начала, а затем по общему количеству байтов — в порядке возрастания. Для указания сортировки по свойству в порядке убывания добавьте перед свойством тире, например-startTime. -
idНеобязательно -
Идентификатор
downloads.DownloadItem, который нужно запросить. -
urlНеобязательно -
Абсолютный URL, с которого была инициирована загрузка, до любых редиректов.
-
filenameНеобязательно -
Абсолютный локальный путь к файлу загрузки, который нужно запросить.
-
dangerНеобязательно -
downloads.DangerType. Включаются толькоDownloadItemsс таким значениемdanger. -
mimeНеобязательно -
MIME-тип. Включаются только
DownloadItemsс этим значениемmime. -
startTimeНеобязательно -
Время в формате ISO 8601. Включаются только
DownloadItemsс этим значениемstartTime. -
endTimeНеобязательно -
Время в формате ISO 8601. Включаются только
DownloadItemsс этим значениемendTime. -
stateНеобязательно -
Состояние загрузки (
in_progress,interrupted, илиcomplete). Включаются толькоDownloadItemsс этим значениемstate. -
pausedНеобязательно -
Признак паузы загрузки (
true, илиfalse). Включаются толькоDownloadItemsс этим значениемpaused. -
errorНеобязательно -
downloads.InterruptReason. Включаются толькоDownloadItemsс этим значениемerror. -
bytesReceivedНеобязательно -
Количество полученных байтов от хоста без учёта сжатия. Включаются только
DownloadItemsс этим значениемbytesReceived. -
totalBytesНеобязательно -
Общее количество байтов в загружаемом файле без учёта сжатия. Включаются только
DownloadItemsс этим значениемtotalBytes. -
fileSizeНеобязательно -
number. Количество байтов в полном файле после разархивирования, или -1, если неизвестно. Число байтов в файле после разархивирования. Включаются толькоDownloadItemsс этим значениемfileSize. -
existsНеобязательно -
Признак существования файла (
true, илиfalse). Включаются толькоDownloadItemsс этим значениемexists.
Совместимость с браузерами
| Настольный | Мобильный | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
DownloadQuery |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
bytesReceived |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
cookieStoreId |
Нет | Нет | 92 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
danger |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
endTime |
Да | 79 | Нет | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
endedAfter |
Да | 79 | 47The parameter is ignored. |
? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
endedBefore |
Да | 79 | 47The parameter is ignored. |
? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
error |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
exists |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
fileSize |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
filename |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
filenameRegex |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
id |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
limit |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
mime |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
orderBy |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
paused |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
query |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
startTime |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
startedAfter |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
startedBefore |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
state |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
totalBytes |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
totalBytesGreater |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
totalBytesLess |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
url |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
urlRegex |
Да | 79 | 47 | ? | Да | Нет | ? | ? | 48–79 | ? | Нет | ? |
Примечание: Этот API основан на API Chromium's chrome.downloads.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery