Spec-Zone.ru › Web Extensions

downloads.DownloadQuery

Тип DownloadQuery API downloads определяет набор параметров, которые могут быть использованы для поиска в диспетчере загрузок конкретного набора загрузок.

Этот тип используется, например, в downloads.search() и downloads.erase(), в качестве объекта запроса для фильтрации набора DownloadItems, которые нужно вернуть или удалить.

Тип

Значения этого типа представляют собой объекты. Они содержат следующие свойства:

cookieStoreId Необязательно

Идентификатор хранилища 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API