downloads.DownloadQuery

此类型的值为对象。它们包含以下属性

cookieStoreId 可选

下载发生时所在的 上下文标识 的 Cookie 存储 ID。有关详细信息，请参阅 使用上下文标识。

query 可选

一个 string 的 array。仅包含 filename 或 url 包含所有给定字符串的 DownloadItems。您还可以包含以连字符 (-) 开头的术语 - 这些术语**不得**包含在项目的 filename 或 url 中，否则它将被包含。

startedBefore 可选

一个 DownloadTime。仅包含在给定时间之前开始的 DownloadItems。

startedAfter 可选

一个 DownloadTime。仅包含在给定时间之后开始的 DownloadItems。

endedBefore 可选

一个 DownloadTime。仅包含在给定时间之前结束的 DownloadItems。

endedAfter 可选

一个 DownloadTime。仅包含在给定时间之后结束的 DownloadItems。

totalBytesGreater 可选

一个表示字节数的 number。仅包含 totalBytes 大于给定数字的 DownloadItems。

totalBytesLess 可选

一个表示字节数的 number。仅包含 totalBytes 小于给定数字的 DownloadItems。

filenameRegex 可选

一个表示正则表达式的 string。仅包含 filename 值与给定正则表达式匹配的 DownloadItems。

urlRegex 可选

一个表示正则表达式的 string。仅包含 url 值与给定正则表达式匹配的 DownloadItems。

limit 可选

一个表示结果数的 integer。仅包含指定数量的 DownloadItems。

orderBy 可选

一个表示 DownloadItem 属性的 string 的 array，搜索结果应按此属性排序。例如，在数组中包含 startTime 然后是 totalBytes 将按其开始时间对 DownloadItems 进行排序，然后按总字节数排序 - 按照升序排序。要指定按属性降序排序，请在属性前加上连字符，例如 -startTime。

id 可选

一个表示要查询的 downloads.DownloadItem 的 ID 的 integer。

url 可选

一个表示启动下载的绝对 URL 的 string，在任何重定向之前。

filename 可选

一个表示要查询的下载文件的绝对本地路径的字符串。

danger 可选

一个表示 downloads.DangerType 的字符串 - 仅包含具有此 danger 值的 DownloadItems。

mime 可选

一个表示 MIME 类型的 string。仅包含具有此 mime 值的 DownloadItems。

startTime 可选

一个表示 ISO 8601 格式时间的 string。仅包含具有此 startTime 值的 DownloadItems。

endTime 可选

一个表示 ISO 8601 格式时间的 string。仅限于具有此 endTime 值的 DownloadItems。

state 可选

一个表示下载downloads.State（in_progress、interrupted或complete）的string类型字符串。仅包含具有此state值的DownloadItems。

paused 可选

一个boolean类型布尔值，指示下载是否已暂停，即已停止从主机读取数据但保持连接打开（true）或未暂停（false）。仅包含具有此paused值的DownloadItems。

error 可选

一个表示downloads.InterruptReason的字符串，即下载中断的原因。仅包含具有此error值的DownloadItems。

bytesReceived 可选

一个number类型数字，表示迄今为止从主机接收到的字节数，不考虑文件压缩。仅包含具有此bytesReceived值的DownloadItems。

totalBytes 可选

一个number类型数字，表示下载文件中总字节数，不考虑文件压缩。仅包含具有此totalBytes值的DownloadItems。

fileSize 可选

number。解压缩后整个文件的字节数，如果未知则为 -1。一个number类型数字，表示文件解压缩后的总字节数。仅包含具有此fileSize值的DownloadItems。

exists 可选

一个boolean类型布尔值，指示下载的文件是否仍然存在（true）或不存在（false）。仅包含具有此exists值的DownloadItems。