类型 Number 事件 networkRequest 修订版 2024.3703 版 关键字 networkRequest, bytesEstimated
如果已知,此值指示给定请求处理的字节数,否则将为 -1
。
此值含义取决于为请求指示的 progress
类型。
如果指定 “upload”
进度,则此值对应于将上传的请求正文大小(如果有的)。值为 0 表示没有请求正文。
如果指定 “download”
进度,或没有指定进度,则此值对应于将下载的响应正文大小(如果有的)。值为 0 表示没有响应正文,值为 -1 表示响应正文大小未知。
发送二进制文件时,Web 服务器通常会报告传输的预期大小,但通常不会报告文本文件(包括 HTML 文档、XML、JSON 等)的预期大小,但此规则也有例外。
此字节数表示预计实际通过网络发送的字节数,可能与响应内容的最终大小无关。例如,许多 Web 服务器在发送之前会压缩内容,在这些情况下,字节数将为要发送的压缩内容字节数。
在某些情况下,Web 服务器可能提供传输大小的“估计值”,此大小不仅可能由于压缩而与实际内容大小不匹配(如上所述),而且可能也不如预期与 bytesReceived 值相关。例如,在请求的 “progress”
阶段,bytesReceived 值完全有可能超出 bytesTotal 值。同样,在请求的 “ended”
阶段,bytesReceived 值可能大于或小于 bytesTotal 值。