浏览器实现 XMLHttpRequest 的upload.onprogress 的原理
- User
浏览器实现 XMLHttpRequest 的upload.onprogress 的原理
Assistant
XMLHttpRequest的upload.onprogress事件的原理,简单来说,是浏览器自身在上传数据到服务器的过程中,实时追踪已经发送的字节数,并据此定期触发事件告知开发者进度。它是一个纯粹的客户端(浏览器)机制,不依赖于服务器的任何响应或配合。
下面我们来详细解析其背后的原理:
-
数据准备与总大小计算 (
total)- 当你调用
xhr.send(data)时,如果data是一个File、Blob对象或者FormData对象(其中包含文件),浏览器在开始发送之前,会先计算出需要发送的整个 HTTP 请求体(Request Body)的总字节数。 - 对于
File或Blob,其size属性就直接提供了总大小。 - 对于
FormData,浏览器会将其内部的数据(包括文本字段和文件)序列化成multipart/form-data格式,并计算出这个序列化后的总大小。 - 这个计算出来的值就是
ProgressEvent对象中的total属性。 - 如果浏览器无法预先计算出总大小(例如,当数据是流式传输,或者没有明确的大小信息时),那么
lengthComputable属性将为false,此时total可能是0。但在文件上传场景,lengthComputable通常为true。
- 当你调用
-
数据发送与内部计数 (
loaded)- 当
xhr.send()方法被调用后,浏览器会启动其内部的网络引擎(例如 Chrome 的 Net stack,Firefox 的 Necko)。 - 浏览器不会一次性将所有数据都塞到网络中,特别是对于大文件。它会将数据切分成小块(chunks)。
- 浏览器将这些数据块写入到底层操作系统的 TCP/IP 栈的发送缓冲区中。每当成功将一个数据块写入到发送缓冲区,或者操作系统确认该数据块已经被成功发送出去(离开了应用程序的控制,进入网络传输阶段),浏览器就会更新一个内部的计数器,记录下已发送的字节数。
- 这个内部计数器累加的值,就是
ProgressEvent对象中的loaded属性。
- 当
-
事件触发机制
- 浏览器不会在每发送一个字节时都触发
onprogress事件,那样会产生过多的事件,影响性能。 - 通常,浏览器会在以下几种情况下触发
upload.onprogress事件:- 当一定数量的字节(例如,每发送 10KB 或 50KB)被成功写入发送缓冲区后。
- 或者,在一个固定的时间间隔内(例如,每 50 毫秒),即使发送的字节数不多,也会触发一次,以确保UI可以定期更新。
- 浏览器内部的网络模块会根据实际发送情况和网络状况来决定触发事件的频率和时机。
- 浏览器不会在每发送一个字节时都触发
-
XMLHttpRequest.upload对象的角色XMLHttpRequest对象本身负责管理整个 HTTP 请求和响应的生命周期。XMLHttpRequest.upload是一个特殊的XMLHttpRequestUpload对象,它专门用于监听请求体(即上传数据)的进展事件。- 这意味着
xhr.upload.onprogress监听的是上传的进度,而xhr.onprogress(不带.upload的) 监听的是下载响应体的进度。
总结原理图:
[浏览器] | | 1. 计算总大小 (total) | (从 File/Blob.size 或 FormData 序列化结果) | | 2. xhr.send(data) | 将数据切块 | | 3. 将数据块写入 OS 的 TCP 发送缓冲区 | (例如,通过 write() 系统调用) | | 4. 浏览器内部计数器累加已写入/发送的字节数 (loaded) | | 5. 达到一定条件 (如字节数阈值或时间间隔) | V [触发 upload.onprogress 事件] | - event.loaded: 已发送字节数 | - event.total: 总字节数 | - event.lengthComputable: 是否可知总大小 V [JS 回调函数] | | 6. 更新 UI (进度条、百分比等) |所以,
upload.onprogress的原理是浏览器利用其对网络传输的控制权和内部计数能力,在数据离开应用程序层进入网络协议栈时,实时跟踪并报告进度。它是一个高效且完全在客户端实现的特性。-
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.