JavaScript Fetch API 怎么处理接口返回的分块数据

浅墨小哥_2393

浅墨小哥_2393

2026-11-19

948人浏览

原创

使用 fetch 处理分块数据(chunked data)的核心方法是读取响应体中的 readablestream,并通过 getreader() 获取读取器进行循环拉取。你需要设置请求头 accept-encoding: gzip, deflate 以允许服务器发送压缩的分块内容,并在代码中通过 reader.read() 的循环不断接收 value(二进制块),直到 done 为 true 时停止。这种方式能实现流式处理,避免等待整个响应加载完毕,适合大文件或实时数据推送场景。

JavaScript Fetch API 怎么处理接口返回的分块数据

如何正确配置请求头以支持分块传输

要让服务器返回分块数据,客户端必须在发起 fetch 请求时显式声明支持压缩编码。通过在 headers 对象中添加 Accept-Encoding 字段并设为 gzip, deflate,可以告知服务器如果资源较大,可以使用这些算法进行分块压缩后传输。如果不设置此头部,某些服务器可能会直接返回未压缩的完整响应,或者拒绝分块传输,导致无法利用流式优势。此外,确保 mode 和 credentials 等参数符合跨域或认证需求,以保证连接建立顺利。

JavaScript Fetch API 怎么处理接口返回的分块数据

const url = 'https://api.example.com/large-data';

async function fetchChunks() {
  const response = await fetch(url, {
    headers: {
      'Accept-Encoding': 'gzip, deflate'
    }
  });

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  // 检查 Content-Length 是否存在,若不存在则确认为分块传输
  const contentLength = response.headers.get('Content-Length');
  console.log('Is chunked:', !contentLength);

  return response.body;
}

上述代码展示了如何发起一个支持分块传输的请求。关键点在于 Accept-Encoding 的设置。运行该函数后,你将获得一个 ReadableStream 对象。如果服务器支持且资源足够大,响应头中将不会包含 Content-Length,或者会包含 Transfer-Encoding: chunked。此时,你可以将返回的 response.body 传递给后续的流处理逻辑。注意,这里只是建立了连接并获取了流引用,实际的数据读取需要在下一步进行。

如何使用 ReadableStream 读取并合并数据

获取到 ReadableStream 后,调用其 getReader() 方法可以获得一个 ReadableStreamDefaultReader 实例。通过在该实例上循环调用 read() 方法,可以逐个获取数据块。每次调用 read() 都会返回一个 Promise,解析后的对象包含 done 布尔值和 value 字节数组。当 done 为 false 时,value 即为当前分块的二进制数据;当 done 为 true 时,表示流已关闭,读取结束。为了得到完整的原始数据,通常需要将所有的 value 拼接起来,或者根据业务需求逐块处理(如解码 JSON、更新 UI 等)。

Java基础版
Java基础版

编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。

下载

JavaScript Fetch API 怎么处理接口返回的分块数据

async function processStream(stream) {
  const reader = stream.getReader();
  const chunks = [];

  while (true) {
    const { done, value } = await reader.read();
    
    if (done) break;
    
    // value 是 Uint8Array,存储当前分块数据
    chunks.push(value);
    console.log(`Received chunk of size: ${value.length}`);
  }

  // 合并所有分块为完整数据
  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
  const combined = new Uint8Array(totalLength);
  let offset = 0;
  for (const chunk of chunks) {
    combined.set(chunk, offset);
    offset += chunk.length;
  }

  return combined;
}

这段代码演示了完整的读取与合并过程。首先创建读取器,然后进入 while 循环。在每次迭代中,await reader.read() 暂停执行直到有新数据到达。收集到的 Uint8Array 被存入 chunks 数组。循环结束后,计算总长度并创建一个新的 Uint8Array 来容纳所有数据,最后通过 set 方法将每个分块复制到正确的位置。最终返回的 combined 变量即为完整的二进制响应体。这种方法确保了即使数据是分块到达的,也能被完整地重组。

如何处理解压后的文本或 JSON 数据

在实际应用中,分块数据往往经过 gzip 压缩,浏览器会自动解压吗?答案取决于环境。在浏览器环境中,fetch 默认会自动处理 gzip 和 deflate 解压,因此你从 value 中拿到的是解压后的原始字节流,无需手动解压。如果数据是 JSON 格式,可以在读取完所有分块后,使用 TextDecoder 将 Uint8Array 转换为字符串,再使用 JSON.parse 解析。对于超大数据,也可以考虑边读边解码,但需注意字符边界问题,通常建议先合并再解码以避免截断多字节字符。

async function fetchAndParseJson(url) {
  const response = await fetch(url, {
    headers: { 'Accept-Encoding': 'gzip' }
  });
  const stream = response.body;
  const reader = stream.getReader();
  const chunks = [];

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    chunks.push(value);
  }

  const totalLength = chunks.reduce((acc, c) => acc + c.length, 0);
  const combined = new Uint8Array(totalLength);
  let offset = 0;
  for (const c of chunks) {
    combined.set(c, offset);
    offset += c.length;
  }

  // 解码为字符串
  const text = new TextDecoder().decode(combined);
  // 解析 JSON
  return JSON.parse(text);
}

此示例展示了从分块流到 JSON 对象的完整转换链路。由于浏览器自动解压,combined 数组中存储的是 UTF-8 编码的原始文本字节。使用 TextDecoder 将其转换为 JavaScript 字符串后,即可安全地调用 JSON.parse。这种模式适用于 API 返回大型 JSON 数组或嵌套对象的情况,能够显著降低内存峰值压力,因为数据是逐步流入而非一次性加载到内存中的。注意,如果数据量极大,合并步骤仍可能占用较多内存,此时可考虑使用更高级的流式 JSON 解析库。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

6066

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1449

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5984

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1080

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2076

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

4105

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

5453

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3580

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

1148

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习