HTML中如何使用ReadableStream处理流式数据

小浩大大_2274

小浩大大_2274

2026-05-03

705人浏览

原创

必须用 TextDecoderStream 将 fetch().body 的 Uint8Array 流解码为字符串流,再交由 htmlparser2 流式解析;DOMParser 不支持流式处理,手动 decode 易出错;需注意响应头、编码、背压及流生命周期管理。

html中如何使用readablestream处理流式数据

fetch().body 是 Uint8Array 流,不是 HTML 字符串流

直接把 response.body 传给 DOMParser 或 innerHTML 会失败,因为它是原始字节流,不是 UTF-8 解码后的字符串。浏览器不会自动解码,中文、emoji、特殊符号全变乱码或解析中断。

  • 必须用 response.body.pipeThrough(new TextDecoderStream()) 转成字符串流;TextDecoderStream 是浏览器原生支持的流式解码器,能正确处理跨 chunk 的多字节字符(比如一个中文被切在两个 Uint8Array 中间)
  • 别用 new TextDecoder().decode(chunk) 手动解码——它不支持 { stream: true },遇到截断字符会抛错或丢字
  • 如果服务端响应头没设 Content-Type: text/html; charset=utf-8,TextDecoderStream 默认仍按 utf-8 解码,一般够用;但若服务端用 gb2312 或 utf-16,得显式传参 new TextDecoderStream('gb2312')

htmlparser2 比 DOMParser 更适合流式 HTML 处理

DOMParser 必须等整个 HTML 字符串加载完才能 parse,一卡全卡;而 htmlparser2 的 Parser 构造函数天生支持流式写入,靠事件驱动,边收边吐。

  • 初始化时设 xmlMode: false(默认即可)、decodeEntities: true,避免实体如   被忽略
  • 每收到一个字符串 chunk,调用 parser.write(chunk);parser 内部会缓存未闭合标签(比如
    跨 chunk),等后续数据到来再继续解析,不崩溃
  • 不要在流结束前调用 parser.end(),否则会强制 flush 并报 “Unexpected end” 错误;应在 reader.read() 返回 { done: true } 后再调用
  • 匹配 <script></script> 或提取 href 时,别依赖 querySelectorAll——DOM 还没建完;改用 onopentag + ontext 回调捕获目标节点
  • 想边读边改 HTML(如重写链接),得自己写 TransformStream

    浏览器没有 HTMLStream 这个标准 API,你在文档里看到的只是 EdgeRoutine 等私有平台的封装。普通网页必须手动组合 TextDecoderStream → TransformStream → 自定义处理器。

    财经HTML高端海报生成
    财经HTML高端海报生成

    复杂得财经如何变成清晰,适合手机看的海报?如何加上你的IP

    下载
    • TransformStream 的 transform() 方法接收 chunk 字符串,你可以用正则替换 /href="([^"]*)"/g,但注意:属性值可能含换行、转义引号(如 href="xxx"),简单正则容易漏
    • 更稳的做法是把 TransformStream 的 readable 端接给 htmlparser2,在 onopentag 里判断 tagName === 'a' 且 attrs.href 存在,再改写后用 this.write(...) 输出新标签
    • 输出必须是合法 HTML 片段(不能只输出 href 属性值),否则下游消费方(比如 WritableStream 写入文件或 document.write)会出错
    • 别忘了设置 desiredSize 或用 controller.enqueue() 控制背压,否则高速流可能撑爆内存

    流式处理失败最常见的三个坑

    不是代码写错,而是对流生命周期和浏览器限制理解不到位。

    • 服务端没开分块传输(Transfer-Encoding: chunked)或返回了 Content-Length 且值固定——这种响应体浏览器仍会当成“可流”,但实际是等全部发完才触发 body 可读,失去流式意义
    • 在主线程里用同步循环(如 while(!done) { await reader.read() })没加 await,导致 Promise 未 resolve 就进入下一轮,value 为 undefined,解码时报错
    • 没监听 abort 信号或没调用 reader.cancel(),用户点取消后流还在后台跑,内存不释放,甚至触发重复回调

    真正难的不是写几行 pipeThrough,而是判断哪一层该缓存状态、哪一层该丢弃引用、哪个错误该重试、哪个该静默吞掉——这些没日志、没调试器,只能靠 chunk 边界和回调触发节奏反推。

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

相关文章

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

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

下载

相关标签:

html stream

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

相关专题

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

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

2023.06.14

6895

7

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

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

2023.06.21

3812

4

html网页制作
html网页制作

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

2023.07.31

3490

5

html空格
html空格

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

2023.08.01

3499

5

html是什么
html是什么

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

2023.08.11

5079

6

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

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

2023.08.11

3441

3

html转txt
html转txt

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

2023.08.31

3249

3

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

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

2023.09.01

2828

6

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

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

2023.09.20

2948

5

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共1课时 | 228人学习