downloads.DownloadItem

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

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

Значение string, представляющее идентификатор расширения, вызвавшего загрузку (если загрузка была вызвана расширением). Это значение не изменяется после установки. Если загрузка не была вызвана расширением, это значение не определено.

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

Значение string, представляющее имя расширения, вызвавшего загрузку (если загрузка была вызвана расширением). Это значение может измениться, если расширение изменит своё имя или пользователь изменит локаль. Если загрузка не была вызвана расширением, это значение не определено.

bytesReceived

Значение number, представляющее количество байтов, полученных до сих пор от сервера во время загрузки; при этом не учитывается сжатие файла.

canResume

Значение boolean, указывающее, можно ли возобновить прерванную (например, приостановленную) загрузку с точки прерывания (true) или нет (false).

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

Идентификатор хранилища cookie контекстуальной учётной записи, в которой произошла загрузка. Подробнее.

danger

Строка, указывающая, считается ли загрузка безопасной или известна как подозрительная. Возможные значения определены в типе downloads.DangerType.

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

Значение string (в формате ISO 8601) представляющее количество миллисекунд между эпохой Unix и временем окончания загрузки. Не определено, если загрузка ещё не завершена.

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

Строка, указывающая причину прерывания загрузки. Возможные значения определены в типе downloads.InterruptReason. Не определено, если ошибка не произошла.

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

Значение string (в формате ISO 8601) представляющее предполагаемое количество миллисекунд между эпохой Unix и предполагаемым временем завершения загрузки. Не определено, если неизвестно (в частности, не определено в DownloadItem, переданном в downloads.onCreated).

exists

Значение boolean, указывающее, существует ли загруженный файл (true) или нет (false). Эта информация может быть устаревшей, так как браузеры не следят автоматически за удалением файлов — для проверки существования файла используйте метод downloads.search(), отфильтровав нужный файл.

filename

Значение string, представляющее абсолютный локальный путь к файлу.

fileSize

Значение number, указывающее общее количество байтов в файле после разархивирования. Значение -1 означает, что размер файла неизвестен.

id

Значение integer, представляющее уникальный идентификатор загруженного файла, сохраняющийся между сеансами браузера.

incognito

Значение boolean, указывающее, записана ли загрузка в истории браузера (false) или нет (true).

mime

Значение string, представляющее MIME-тип загруженного файла.

paused

Значение boolean, указывающее, приостановлена ли загрузка, т.е. если загрузка остановила чтение данных с сервера, но сохранила соединение открытым. Если да, то значение true, иначе false.

referrer

Значение string, представляющее ссылку-источник загруженного файла.

startTime

Значение string (в формате ISO 8601) представляющее количество миллисекунд между эпохой Unix и временем начала загрузки.

state

Значение string, указывающее, идёт ли загрузка, прервана или завершена. Возможные значения определены в типе downloads.State.

totalBytes

Значение number, указывающее общее количество байтов загружаемого файла. При этом не учитывается сжатие файла. Значение -1 означает, что общее количество байтов неизвестно.

url

Значение string, представляющее абсолютный URL, с которого был загружен файл.