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 可選

一個 `string` 組成的 `array`，表示應按其對搜尋結果進行排序的 DownloadItem 屬性。例如，在陣列中包含 `startTime` 然後是 `totalBytes` 將按開始時間、然後是總位元組數對 DownloadItems 進行升序排序。要指定降序排序，請在其前面加上連字元，例如 `-startTime`。

id 可選

一個 `integer`，表示您要查詢的 downloads.DownloadItem 的 ID。

url 可選

一個 `string`，表示下載的起始絕對 URL，在任何重定向之前。

filename 可選

一個 `string`，表示您要查詢的下載檔案的絕對本地路徑。

danger 可選

一個 `string`，表示 downloads.DangerType — 僅包含具有此 `danger` 值的 DownloadItems。

mime 可選

一個 `string`，表示 MIME 型別。僅包含具有此 `mime` 值的 DownloadItems。

startTime 可選

一個 `string`，表示 ISO 8601 格式的時間。僅包含具有此 `startTime` 值的 DownloadItems。

endTime 可選

一個 `string`，表示 ISO 8601 格式的時間。僅包含具有此 `endTime` 值的 DownloadItems。

state 可選

一個 `string`，表示下載 downloads.State（in_progress、interrupted 或 complete）。僅包含具有此 `state` 值的 DownloadItems。

paused 可選

一個 `boolean`，表示下載是否已暫停 — 即，已停止從主機讀取資料，但保持連線開啟（true），或者未暫停（false）。僅包含具有此 `paused` 值的 DownloadItems。

error 可選

一個 `string`，表示 downloads.InterruptReason — 下載中斷的原因。僅包含具有此 `error` 值的 DownloadItems。

bytesReceived 可選

一個 `number`，表示當前從主機接收到的位元組數，不考慮檔案壓縮。僅包含具有此 `bytesReceived` 值的 DownloadItems。

totalBytes 可選

一個 `number`，表示下載檔案的總位元組數，不考慮檔案壓縮。僅包含具有此 `totalBytes` 值的 DownloadItems。

fileSize 可選

number。解壓縮後整個檔案中的位元組數，如果未知則為 -1。一個 `number`，表示解壓縮後文件中總位元組數。僅包含具有此 `fileSize` 值的 DownloadItems。

exists 可選

一個 `boolean`，指示下載的檔案是否存在（true）或不存在（false）。僅包含具有此 `exists` 值的 DownloadItems。

瀏覽器相容性