Skip to content
TheChatArchiveThe Chat Archive
Geminigemini-2.5-flash· GoogleHugging Face LMArena Human Preference 140K

浏览器实现 XMLHttpRequest 的upload.onprogress 的原理

From a Chatbot Arena battleThe same person sent this prompt to two anonymous models at once. Compare it with Coherecommand-a-03-2025’s answer.
  1. User

    浏览器实现 XMLHttpRequest 的upload.onprogress 的原理

  2. Gemini Assistant

    XMLHttpRequest 的 upload.onprogress 事件的原理,简单来说,是浏览器自身在上传数据到服务器的过程中,实时追踪已经发送的字节数,并据此定期触发事件告知开发者进度。

    它是一个纯粹的客户端(浏览器)机制,不依赖于服务器的任何响应或配合。

    下面我们来详细解析其背后的原理:

    1. 数据准备与总大小计算 (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。
    2. 数据发送与内部计数 (loaded)

      • 当 xhr.send() 方法被调用后,浏览器会启动其内部的网络引擎(例如 Chrome 的 Net stack,Firefox 的 Necko)。
      • 浏览器不会一次性将所有数据都塞到网络中,特别是对于大文件。它会将数据切分成小块(chunks)。
      • 浏览器将这些数据块写入到底层操作系统的 TCP/IP 栈的发送缓冲区中。每当成功将一个数据块写入到发送缓冲区,或者操作系统确认该数据块已经被成功发送出去(离开了应用程序的控制,进入网络传输阶段),浏览器就会更新一个内部的计数器,记录下已发送的字节数。
      • 这个内部计数器累加的值,就是 ProgressEvent 对象中的 loaded 属性。
    3. 事件触发机制

      • 浏览器不会在每发送一个字节时都触发 onprogress 事件,那样会产生过多的事件,影响性能。
      • 通常,浏览器会在以下几种情况下触发 upload.onprogress 事件:
        • 当一定数量的字节(例如,每发送 10KB 或 50KB)被成功写入发送缓冲区后。
        • 或者,在一个固定的时间间隔内(例如,每 50 毫秒),即使发送的字节数不多,也会触发一次,以确保UI可以定期更新。
        • 浏览器内部的网络模块会根据实际发送情况和网络状况来决定触发事件的频率和时机。
    4. 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 的原理是浏览器利用其对网络传输的控制权和内部计数能力,在数据离开应用程序层进入网络协议栈时,实时跟踪并报告进度。它是一个高效且完全在客户端实现的特性。

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.