Skip to content
The Chat Archive
command-a-03-2025· Cohere LMArena Human Preference 140K

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

  1. User

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

  2. Assistant

    XMLHttpRequest 的 upload.onprogress 事件用于监听文件上传的进度。其实现原理涉及浏览器内部对 HTTP 请求的处理,特别是对于 POST 请求中包含文件数据的情况。以下是其工作原理的详细解释:


    1. XMLHttpRequest 的上传流程

    当使用 XMLHttpRequest 发送包含文件的数据(例如通过 FormData 对象)时,浏览器会将请求分为两个部分:

    • 请求头(Header):包含请求的元信息,如方法、URL、内容类型等。
    • 请求体(Body):包含实际要上传的数据,如文件内容。

    对于文件上传,浏览器会将文件数据分块发送到服务器,而不是一次性发送全部数据。


    2. 上传进度监听

    XMLHttpRequest 的 upload 属性是一个专门用于监听上传事件的对象。upload.onprogress 事件会在上传过程中定期触发,以报告当前上传的进度。

    事件触发原理:

    • 分块发送:浏览器将文件数据分成多个小块(chunk),逐块发送到服务器。
    • 进度计算:每发送一个块后,浏览器会计算已发送的数据量与总数据量的比例,并触发 upload.onprogress 事件。
    • 事件参数:onprogress 事件回调函数会接收一个 ProgressEvent 对象,其中包含以下属性:
      • loaded:已上传的数据量(字节)。
      • total:总数据量(字节)。
      • lengthComputable:是否可以计算总数据量(对于文件上传通常是 true)。

    3. 浏览器内部实现

    浏览器内部通过以下步骤实现 upload.onprogress:

    1. 初始化请求:当调用 xhr.send() 时,浏览器开始构建 HTTP 请求。
    2. 分块发送数据:对于大文件,浏览器会将其分成多个块,逐块发送到服务器。
    3. 跟踪进度:浏览器内部维护一个计数器,记录已发送的数据量。
    4. 触发事件:每发送一个块后,浏览器检查是否需要触发 upload.onprogress 事件,并更新 loaded 值。
    5. 完成上传:当所有数据发送完毕后,upload.onload 事件会被触发。

    4. 示例代码

    以下是一个使用 upload.onprogress 监听文件上传进度的示例:

    const xhr = new XMLHttpRequest();
    const formData = new FormData();
    formData.append('file', fileInput.files[0]);
    
    xhr.open('POST', '/upload', true);
    
    xhr.upload.onprogress = function(event) {
      if (event.lengthComputable) {
        const percentComplete = (event.loaded / event.total) * 100;
        console.log(`上传进度:${percentComplete.toFixed(2)}%`);
      }
    };
    
    xhr.upload.onload = function() {
      console.log('上传完成');
    };
    
    xhr.send(formData);
    

    5. 注意事项

    • 浏览器兼容性:upload.onprogress 在现代浏览器中广泛支持,但需注意旧版浏览器的兼容性。
    • 服务器响应:服务器需要正确处理分块数据,并返回适当的响应(如 200 OK)以确保上传成功。
    • 性能优化:对于大文件上传,建议在客户端对文件进行分片处理,并结合 upload.onprogress 实现进度显示和暂停/恢复功能。

    通过以上原理,upload.onprogress 事件能够实时反馈文件上传的进度,为用户提供更好的交互体验。

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