downloads.DownloadItem

downloads API 的 DownloadItem 类型表示一个被下载的文件。

类型

这个类型的值是包含以下属性的对象：

byExtensionId可选: 一个代表了触发此下载的扩展的 ID 的 string（如果下载是由扩展触发的）。一旦设置，不会改变。如果下载不是由扩展触发的，则为 undefined。
byExtensionName可选: 一个代表了触发此下载的扩展的名字的 string（如果下载是由扩展触发的）。如果用户改变了扩展的语言环境，则这个属性的值也可能变化。如果下载不是由扩展触发的，则为 undefined。
bytesReceived: 一个代表了在下载过程中从主机接收到的字节数的 number；此处不考虑文件的压缩。
canResume: 一个标识当前中断（例如暂停）的下载是否可以从当前位置恢复的 boolean，如果可以恢复则为 true，否则为 false。
cookieStoreId 可选: 进行下载操作的场景身份的 cookie 存储 ID。详细信息请参见使用场景身份。
danger: 一个 string，标识这个下载是否通过一个不安全的或已知的可疑的站点。其可能的值在 downloads.DangerType 类型中定义。
endTime可选: 一个 string（采用 ISO 8601 格式），表示从 UNIX 纪元到此下载结束时的毫秒数。如果下载尚未完成，则为 undefined。
error可选: 一个 string，指示下载中断的原因。可能的值在 downloads.InterruptReason 类型中定义。如果未发生错误，则为 undefined。
estimatedEndTime可选: 一个 string（采用 ISO 8601 格式），表示从 UNIX 纪元到预计下载完成时的毫秒数。如果未知（特别是在传递给 downloads.onCreated 的 DownloadItem 中），则为 undefined。
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。