如何通过HTML的ReadableStream的getReader获取读取器逐块处理数据

风婷君_1164

风婷君_1164

2026-05-11

789人浏览

原创

readablestream.getreader() 返回 readablestreamdefaultreader,需手动调用 read() 获取数据;read() 返回 promise,done 为 true 时流结束,value 为 undefined;uint8array 需用 textdecoder 解码;cancel() 终止流,releaselock() 仅释放读取权。

如何通过html的readablestream的getreader获取读取器逐块处理数据

ReadableStream.getReader() 返回的 reader 怎么用

直接调用 getReader() 得到的是一个 ReadableStreamDefaultReader,它不自动读取数据,也不触发流消费——你得手动调用 reader.read() 才会拉取下一块。常见错误是以为调用 getReader() 后流就“开始流了”,其实只是拿到了控制权。

典型使用场景包括:处理大文件上传响应、解析长 JSON 流、实时日志流、或避免一次性加载整个 Response.body 到内存。

  • reader.read() 返回 Promise
  • 当 done === true 时,流已彻底结束,value 为 undefined
  • 每次 read() 只取一块(chunk),大小由底层决定,不是固定字节数
  • 不能对同一个 reader 多次并发调用 read();必须等前一个 Promise settle 后再调下一个

为什么用 while (true) + await read() 容易卡死

写成 while (true) { const { value, done } = await reader.read(); if (done) break; process(value); } 看似自然,但实际在某些环境(比如 Chrome DevTools 控制台、某些 Service Worker 上下文)中,如果流没有及时 push 数据,这个循环可能因 Promise 永不 resolve 而挂起整个 async 函数,且无超时提示。

更稳妥的做法是显式处理 pending 状态,并预留中断能力:

html-deploy
html-deploy

使用 htmlcode.fun 将 HTML 内容或文件部署到网页,适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

下载
  • 用 for await...of 更安全(它内部做了 done 判断和异常传播)
  • 若必须手动 read(),建议加 if (!value && done) break; 双重判断
  • 避免在非流式上下文中(如普通 fetch 后直接 .body.getReader())误以为有持续 chunk —— 大多数 HTTP 响应 body 是单 chunk 或两 chunk(header + body),除非服务端启用了 Transfer-Encoding: chunked 或 streaming JSON

Uint8Array 怎么转成字符串或 JSON

reader.read() 返回的 value 是 Uint8Array,不是字符串。直接 value.toString() 会得到逗号分隔的数字列表,不是原始文本。

  • 转字符串:用 new TextDecoder().decode(value)(推荐,支持 UTF-8 自动处理)
  • 转 JSON(假设流是合法 JSON 分块):先累积所有 Uint8Array 到 Uint8Array 合并数组,再整体 decode;不要每块都 JSON.parse(),因为 JSON 不可分割(比如 {"a": 可能在第一块,1} 在第二块)
  • 若需边收边解析(如 NDJSON / JSONL),每块需按换行切分,再逐行 JSON.parse(),注意跨块换行断裂问题

reader.cancel() 和 reader.releaseLock() 的区别在哪

这两个方法常被混淆:cancel() 是通知流“我不需要后续数据了”,会触发流的取消逻辑(如 abort underlying source),适合出错或提前终止;releaseLock() 只是释放 reader 对流的独占权,让其他 reader 可以获取——但流本身还在运行,且你不能再用这个 reader。

  • 一旦调用 releaseLock(),再调 read() 会抛 TypeError: Reader was released
  • 流结束(done === true)后,reader 自动释放锁,无需手动 releaseLock()
  • 忘记 cancel() 可能导致资源泄漏(比如 Fetch 中的连接未关闭),尤其在 abort 逻辑里
  • 在 finally 块中根据状态选择调用:正常结束不用 cancel,异常或中断才 reader.cancel()

真正难的不是调用 getReader(),而是理解流的生命周期与 reader 的所有权模型——它不像 Node.js 的 Readable 那样有 pause/resume,也没有内置缓冲区管理,所有节流、错误恢复、编码转换都得自己兜底。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

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

下载

相关标签:

html stream

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

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

5635

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3212

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

2870

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

2899

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4739

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2841

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2649

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2368

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2388

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 219人学习